Integration
Sandbox Testing
Integration
Sandbox Testing
Test the Guest checkout debit card flow in our sandbox!
Instructions
On the payment method page, you can use the following values when filling out the form (do not use real phone numbers or card numbers):
| Field | Input value |
|---|---|
| Phone number | Any valid US 10-digit phone number e.g. (212) 123-1234. Note: you will not receive a text message if you use a real phone number. |
| Any valid email string e.g. john.doe@gmail.com | |
| Name on card | Any first and last name e.g. John Doe |
| Card number | 4242 4242 4242 4242 to simulate a successful transaction. Any other 16-digit card number to simulate a declined transaction. |
| Expiry date | Any valid expiry date e.g. 12/31 |
| CVC | Any 3-digit CVC e.g. 123 |
| Billing address | Any valid US address (you can start typing for suggestions). e.g. 123 Market Street, San Francisco, CA 94105 |
After completing the payment method page, you will see the phone verification page. You can input any 6-digit code here (e.g. 000000).
Creating sandbox URLs
You can test different Onramp configurations by modifying the query parameters in the sandbox URL. Session tokens are also supported.
Example URLs
Sandbox URL parameters:
| Parameter | Required | Type | Description |
|---|---|---|---|
appId | Yes | String | The Project ID found on the project Dashboard |
addresses | Yes | Record<Address> | An object whose keys are addresses and values are arrays of networks each address supports. (e.g. addresses={"0x1":["base"]}) Note: no tokens will be sent to the set addresses in sandbox. |
sessionToken | No | String | Token generated by the Onramp Session Token API. Only required if Require secure initialization is true. If this is set, appId and addresses parameters are not required. |
assets | No | String[] | List of assets that will be available for the user to buy/send. e.g. [“ETH”, “USDC”] or UUIDs retrieved from the Buy Options API. This optional parameter acts as a filter on the addresses parameter. If it is included then only the assets in this list that are available on one of the supported blockchains in the Addresses list will be available to the user. See the See the Buy Options API for the full list of assets. |
defaultNetwork | No | String | Default network that should be selected when multiple networks are present |
defaultAsset | No | String | Default asset that should be selected when multiple assets are present |
presetCryptoAmount | No | Number | Preset crypto amount value |
presetFiatAmount | No | Number | Preset fiat amount value (for USD only in sandbox). Ignored if presetCryptoAmount is also set. |