Payout Quotes

What is a payout quote?

A quote will show you how much you or your customers need to send in stablecoins and how much the receiver is going to receive in fiat.

So, let's say you want to send 1,000 USDC to a receiver with a bank account in the United States. The quote will show that you need to send 1,000 USDC and the receiver will receive $999.

Who are going to pay for the fees?

BlindPay provides two ways of paying for the fees:

1. The receiver pays the fees: In this case, the fees are calculated based on the fiat currency (USD, BRL) that the receiver is going to receive.
2. The sender pays the fees: In this case, the fees are calculated based on the stablecoins (USDC) that the sender is going to send.

Receiver paying for the fees

This is the most common scenario, so just keep the Cover all payout fees disabled and the fees will be calculated to the receiver.

Sender paying for the fees

This scenario is particularly relevant when running payroll. In this case, you should enable the Cover all payout fees option before creating the quote.

Swift documents

Please ensure you're submitting the following fields when initiating a Swift payout, the document MUST show a relationship between the originator and the recipient:

• transaction_document_type: Document type
• transaction_document_id (optional): Document ID number
• transaction_document_file: Document file

Accepted document types:

• invoice: Invoice
• purchase_order: Purchase Order
• delivery_slip: Delivery Slip
• contract: Contract
• customs_declaration: Customs Declaration
• bill_of_lading: Bill of Lading
• others: Others

Creating a quote

You can check the required fields in the BlindPay API Docs.

Before creating a quote through the API, you need to:

1. Create an account on BlindPay
2. Create a development instance
3. Create your API key
4. Create a receiver
5. Add a bank account

curl --request POST \
  --url https://api.blindpay.com/v1/instances/in_000000000000/quotes \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "bank_account_id": "ba_000000000000",
  "currency_type": "sender",
  "cover_fees": false,
  "request_amount": 1000,
  "network": "sepolia",
  "token": "USDC",
  "transaction_document_type": "invoice", // Only for swift payouts
  "transaction_document_id": "1234567890", // Only for swift payouts (optional)
  "transaction_document_file": "https://example.com/document.pdf" // Only for swift payouts
}'