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

Name	Type	Description
user_id*	UUID	The ID in Pay.so for the User who is making the payment.

Request Body

Name	Type	Description
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.

200: OK

{ 
  "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.