Offramps#Create

Tell us which banks we should pay once your quote is executed.

Pay.so supports batch-payments by taking an array of Offramp objects. If you'd like to just pay one bank, just put one Offramp object in the array. The sum of all the destination_amount values must be less than or equal to the deposit_token_amount that was given on the associated quote.

Batch swift payments are not supported on V0, please use V1 instead.

Example Request

curl https://{{base_url}}/users/USER_ID/quotes/QUOTE_ID/offramps \
-X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-type: application/json" \
-d '{
    "offramps": [
        {
            "payment_detail_id": "fa898aec-519c-46be-9b4c-e76ef4ff99d9",
            "destination_amount": 19000,
            "destination_currency": "eur",
            "reference": "Payment for Services #1010",
            "supporting_document_attributes": {
                "submitted_url": "https://web3accounting.com/invoices/in_378949x.pdf"
            }
        },
        {
            "payment_detail_id": "576b17c9-db11-4593-a362-52605408a1b5",
            "destination_amount": 1000,
            "destination_currency": "eur",
            "reference": "Payment for Services #1011",
            "supporting_document_attributes": null
        }
    ]
}' 

Endpoint Information

Create Offramps

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

Path Parameters

Name	Type	Description
user_id*	UUID	The ID in Pay.so for the user who is making the payment.
quote_id*	UUID	The ID in Pay.so for the Quote which these payments relate to.

Request Body

Name	Type	Description
submitted_url	String	A URL to a hosted document that explains the reason for the transaction, such as an invoice or a payslip. Required if the amount is above 15000 EUR or 10000 USD, or at any amount if the payment rails are swift. URL must point to the document file itself and not a webpage hosting the document.
payment_detail_id*	UUID	The ID of the Payment Detail (bank account) where the fiat payment should be made to.
destination_amount*	String	The amount in fiat currency that should be delivered to the Payment Detail. The amount must be over the minimum limit of the destination_currency.
reference	String	The reference message you would like on the fiat payment (only works on EUR routes).
supporting_document_attributes	Object	An object containing a URL to submitted_url. Only required if a submitted_url is required.
destination_currency*	String	The currency that should be delivered to the Payment Detail, e.g. usd, eur

200: OK

{ 
   "offramps": [
      {
         id: "074cb3e4-1f56-4916-8024-ecbf6f805b90",
         user_id: "a25a4274-8f50-4579-b476-8f35b297d4ad",
         payment_detail_id: "fa898aec-519c-46be-9b4c-e76ef4ff99d9",
         quote_id: "1e99d470-dcc2-46f4-970c-bc35a9e13b84",
         status: "initiated",
         status_message: null,
         destination_amount: 19000,
         destination_currency: "eur",
         reference: "Payment for Services #1010",
         supporting_document: {
            submitted_url: "https://web3accounting.com/invoices/in_378949x.pdf",
            status: "not_checked"
         }
      },
      {
         id: "074cb3e4-1f56-4916-8024-ecbf6f805b90",
         user_id: "a25a4274-8f50-4579-b476-8f35b297d4ad",
         payment_detail_id: "576b17c9-db11-4593-a362-52605408a1b5",
         quote_id: "1e99d470-dcc2-46f4-970c-bc35a9e13b84",
         status: "initiated",
         status_message: null,
         destination_amount: 1000,
         destination_currency: "eur",
         reference: "Payment for Services #1011",
         supporting_document: null
      }
   ]
}