Quotes#Create

Tell us the total amount of fiat you want us to pay out, and we'll tell you how much crypto to pay in and where to send it to.

If you are performing a batch payment, fiat_amount should be the total amount of all the sub-transactions.

Example request

curl https://{{base_url}}/users/USER_ID/quotes
-X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-type: application/json" \
-d '{
       "quote": {
          "deposit_token": "usdc",
          "deposit_token_chain": "ethereum",
          "deposit_token_amount": null,
          "fiat_amount": "20000",
          "fiat_currency": "eur",
          "rails": null
       }
}'

Endpoint Information

Create a quote

POST https://{{base_url}}/users/:user_id/quotes

Get the required information to create an offramp.

Path Parameters

NameTypeDescription

user_id*

UUID

The ID in Pay.so for the User who is making the payment.

Request Body

NameTypeDescription

deposit_token*

String

Symbol of the token to be liquidated. Can be usdc, usdt.

deposit_token_chain*

String

Blockchain of the token to be liquidated. Can be polygon, ethereum

deposit_token_amount

String

Can be left null as long as fiat_amount is provided. Whichever value is missing will be filled out in the response. Take note of our minimum limit requirement below.

fiat_amount

String

Amount of fiat currency you would like deposited. Can be null if deposit_token_amount is provided. Whichever value is missing will be filled out in the response. Take note of our minimum limit requirement below.

fiat_currency*

String

Currency you would like the fiat delivered in. E.g. "usd"

rails

String

If the account(s) you are paying are on the SWIFT network, put the value of this attribute toswift. Otherwise if it is SEPA/ACH or other local rails you can leave it as null. Please see SWIFT Support to understand what is supported.

{ 
  "quote":
    {
      "id": "1e99d470-dcc2-46f4-970c-bc35a9e13b84",
      "user_id": "a25a4274-8f50-4579-b476-8f35b297d4ad"
      "deposit_token": "usdc",
      "deposit_token_chain": "ethereum",
      "deposit_token_amount": 1047,
      "fiat_amount": 1000,
      "fiat_currency": "eur",
      "expiry": 1_366_762_500,
      "fees": 10.0,
      "rate": 0.92820,
      "executed": false,
      "rails": null
    },
    "deposit_address": {
      "adddress": "0x709c56AfDAdBDCAB4f7a6aAe99644C91C3eF67eF",
      "blockchain": "ethereum"
    },
    "crypto_transfer": null,
    "offramps": []
}

Minimum Limits

Please see the Minimum Limits section to ensure your payment meets the minimum amounts.

Last updated