> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reap.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup

> What your project and your customers need before the first purchase.

No per-user setup is required before a first purchase. The user provides or selects their card on the Reap-hosted approval page during checkout, so your application only needs an enabled project and a way to identify its customers.

<Steps>
  <Step title="Enable Agentic Payments on your project" icon="toggle-right">
    Agentic Payments is not generally available. Contact Reap to enable it for your project in the sandbox. Calls to the agentic endpoints fail until the capability is enabled.
  </Step>

  <Step title="Identify your customer" icon="user">
    Each checkout carries an `owner` with your own reference for the customer and an optional email. Use a stable identifier from your system so purchases associate with the same customer over time.
  </Step>

  <Step title="Let the hosted page collect the card" icon="credit-card">
    The user enters or selects a card on the hosted approval page when they approve a purchase. Card details travel from the cardholder to the secure surface and never touch your application or the agent.
  </Step>
</Steps>

## On the roadmap

A one-time setup will replace the per-purchase card step:

* An enrollment vaults the card once on a secure Reap-hosted surface, and later purchases pay with single-use credentials instead of the card number
* Users onboarded through the Reap API will enroll a Reap-issued card by its card id. [Create a user](/api-reference/users/create-user), [Advance the user application](/api-reference/users/advance-the-user-application), and [Create an account](/api-reference/accounts/create-account) cover that onboarding journey today
* Cards issued under a Reap BIN sponsorship will enroll through the same secure passthrough
* A payment passkey created during enrollment will let the user approve purchases with one biometric tap

## Test cards

Seamless Reap-issued card enrollment via `cardId` is not yet available. Use these test cards on the hosted card entry page to run the full payment flow in the sandbox. They behave like real cards but never move money. Reap adds more cards and networks as it supports them.

<Note>
  These cards only work through the Agentic Payments API and are declined everywhere else.
</Note>

| Card number         | CVC | Expiry |
| ------------------- | --- | ------ |
| 4622 9431 2313 7797 | 640 | 12/27  |
| 4622 9431 2313 7805 | 304 | 12/27  |
| 4622 9431 2313 7847 | 698 | 12/27  |

## One-time passwords

The card verification step may ask for a one-time password. Enter `456789`. The same code works whether you choose email or SMS delivery.

## Next steps

<Card title="Make a one-time purchase" icon="shopping-bag" href="/agentic-payments/one-time-purchases">
  Run the first purchase from product search to the completed order
</Card>
