Skip to main content
On-ramping is converting fiat currencies into stablecoins such as USDT or USDC. This conversion is facilitated by the PFIs on the Borderless network and can be part of either a payin or payout flow simply depending on if you are sending or receiving the payments. In this scenario you are ultimately sending or receiving stablecoins, after the local fiat currencies are converted at the PFI. On-ramps are a simple 3 step process. Optionally, you can also request a quote before initiating the on-ramp to have a transparent view of the estimated fees and exchange rates.
Quotes are returned directly from the PFIs, and are regularly changing. Quotes are not firm, and they do not guarantee any final received amount. They are estimates only, and Borderless is not responsible for incorrect quotes provided to us by PFIs.
Endpoint: GET /deposits/quotes
curl -X GET 'https://sandbox-api.borderless.xyz/v1/deposits/quotes' \
     -H 'Authorization: Bearer your-access-token' \
     -H 'Content-Type: application/json' \
     -d '{  
            "country": "US",
            "fiat": USD,
            "asset": "USDC_POLYGON",
            "paymentMethod": "ACH"
			"fromAmount": "10"
        }'

​
Create an on-ramp order

First, you will create an order for an on-ramp. This will return the payment instructions from the PFI, for the payment originator to send the local fiat currency. This alerts the PFI to expect the payment, and allows them to attribute the funds to your account when they arrive.
Please use account id in the on-ramp creation request from an account created above in the Accounts section.
Please note: if KYB or KYC are in progress, you’ll see "instructions":null in the response. To fetch the payment instructions after order creation, you can subscribe to a Webhook or use GET /transactions/{id}using the on-ramp id from the response.
Endpoint: POST /deposits
curl -X POST 'https://sandbox-api.borderless.xyz/v1/deposits' \
      -H 'Authorization: Bearer your-access-token' \
      -H 'Content-Type: application/json' \
      -H 'idempotency-key: 8f14e45f-e6c3-4f7e-bd56-1b9a2e46f1d6'\
      -d '{  
            "fiat": "USD",
            "amount": 1000.00,
            "asset": "USDC_POLYGON",
            "accountId": "account_id_from_prevous_step",
            "paymentMethod": "ACH",
            "country": "US"
        }'

​
Send local fiat direct to PFI

Second, the payment originator follows the payment instructions that were returned in the first step, and sends the local fiat to the PFI directly. This step takes place directly with the PFI, over traditional local rails such as ACH, Wire, or PIX depending on region.
The PFI will be expecting the inbound fiat transfer to match the order created via the /deposits endpoint, please ensure you are following the payment instructions exactly.Borderless cannot be held responsible for transfers that originate outside the Borderless network to incorrect addresses. It is your responsibility to review the payment instructions exactly as they are returned from our partner financial institutions (PFIs).

​
Release stablecoins to beneficiary

Third, the PFI will issue the stablecoins to the specified stablecoin wallet, as defined in your account set up above in the Accounts section. Once the stablecoins are received, this completes the on-ramp or deposit flow. You can easily track the status of transactions, request cancellation of transactions, and export transactions with the following endpoints.
Please ensure you are using the transaction id value which you will receive from the request to create a transaction such as the first step in this sequence on the /deposits endpoint.
To track the status of your deposit transactions and other types of transactions:
We recommend listening to the statuses via Webhook.
Endpoint: GET /transactions/{id}
To request a cancellation of your deposit transaction and other types of transactions:
Endpoint: POST /transactions/{id}/cancel
To export your transactions:
Endpoint: GET /transactions/export
Congratulations! You’ve now completed your first stablecoin payment!
If you have any questions, please don’t hesitate to reach out to us via email or slack.