Payin Quotes

Create Payin Quote

Changed on

Prices a payin from a local payment method into a stablecoin wallet. Send one of wallet_id (BlindPay-managed wallet) or blockchain_wallet_id. Do not send a network: the wallet decides where the tokens are delivered. request_amount is in cents; the minimum depends on the currency (1000, which is 10.00, for USD and BRL) and OTC quotes have a higher minimum. funding_bank_account_id is required when payment_method is ach_pull. The quote expires 5 minutes after creation, or 10 seconds for OTC quotes; create the payin with Create Payin before then.

post/v1/instances/{instance_id}/payin-quotes

Request

  • Base URL: https://blindpay.com (the document declares no server; this is the origin it was published from)
  • URL: https://blindpay.com/v1/instances/{instance_id}/payin-quotes
  • Auth: HTTP bearer

Path parameters

instance_idstring required
Example:in_000000000000

Headers

Idempotency-Keystring

Optional key to safely retry this request without performing the action twice. Retrying with the same key and an identical body replays the original response; reusing a key with a different body returns an error. Keys are kept for 24 hours.

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Request body

blockchain_wallet_idstring nullable
wallet_idstring nullable
currency_type'sender' | 'receiver' required
cover_feesboolean nullable

If true, the sender will cover the fees. If false, the customer will cover the fees.

request_amountinteger required

1000 represents 10.00, 2050 represents 20.50

payment_method'ach' | 'ach_pull' | 'wire' | 'pix' | 'card' | 'ted' | 'spei' | 'transfers' | 'pse' | 'international_swift' | 'rtp' required
token'USDC' | 'USDT' | 'USDB' required
partner_fee_idstring nullable
is_otcboolean nullable

If true, the payin quote is for an OTC (Over the Counter) transaction

funding_bank_account_idstring nullable

Plaid-connected bank account that funds the payin by ach pull. Required when payment_method is ach_pull, not accepted otherwise.

Example request

{
  "blockchain_wallet_id": "bw_000000000000",
  "wallet_id": "bl_000000000000",
  "currency_type": "sender",
  "cover_fees": true,
  "request_amount": 1000,
  "payment_method": "pix",
  "token": "USDC",
  "partner_fee_id": "pf_000000000000",
  "payer_rules": {
    "pix_allowed_tax_ids": [
      "123.456.789-09"
    ],
    "transfers_allowed_tax_id": "20-12345678-6",
    "pse_allowed_tax_ids": [
      "1234567890"
    ]
  },
  "funding_bank_account_id": "ba_000000000000"
}

Response

Payin Quote creation details

idstring required
expires_atnumber nullable required

Epoch timestamp in milliseconds after which the quote can no longer be used to create a payin: 5 minutes after creation, or 10 seconds for OTC quotes.

commercial_quotationnumber nullable required

1 USD = 4.95 BRL

blindpay_quotationnumber nullable required

1 USD = 5.05 BRL (commercial quotation + (blindpay taxes))

receiver_amountnumber nullable required

10.10 USDC

sender_amountnumber nullable required

52.40 BRL needs to be sent in a pix transfer

partner_fee_amountnumber nullable

1.5 USDC

flat_feenumber nullable required

0.5 USDC

billing_fee_amountnumber nullable

BlindPay fee in cents accrued to your billing cycle (charged at the end of the month). Virtual account deposits below $100.00 always accrue here, so small deposits are delivered in full.

is_otcboolean nullable

If true, the payin quote is for an OTC (Over the Counter) transaction

Example response

{
  "id": "qu_000000000000",
  "expires_at": 1712958191000,
  "commercial_quotation": 495,
  "blindpay_quotation": 505,
  "receiver_amount": 1010,
  "sender_amount": 5240,
  "partner_fee_amount": 150,
  "flat_fee": 50,
  "billing_fee_amount": 50
}

Changes