Stablecoin Funding Source - Lead | API Docs

The following example shows a request where the debtor sends stablecoins and the creditor receives foreign currency (over blockchain rails) or dollars.

POST /v0/blockchain_payments

Auth Scope: blockchain_payment/read_write

Example

Crypto-to-Fiat

Request

{
    "debtor": {
        "account_identifier":
        {
            "type": "wallet_address",
            "value": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        "chain": "base",
        "entity_id": "entity_67890",
        "refund_wallet_address": "0xB9m86771c6218b36c1d19D4a2e9Eb0cE3606eB49"
    }
    "creditor":
    {
        "payment_rail": "spei",
        "clabe":
        {
            "account_number": "00218090010000001234"
        },
        "type": "business",
        "business":
        {
            "business_name": "Acme Mexico SA de CV"
        },
        "address":
        {
            "line_one": "Av. Reforma 123",
            "city": "Ciudad de México",
            "country": "MX",
            "postal_code": "06600"
        }
    },
    "creditor_agent":
    {
        "bank_name": "BBVA México",
        "country_code": "MX"
    },
    "amounts": 
    {
        "instructed_amount": 1000000,
        "instructed_currency_code": "USDC",
        "settlement_currency_code": "MXN"
    },
    "payment_purpose":
    {
        "type": "payment_for_goods"
    },
    "reference": "INV-MXN-2026-001",
}

Success Response (200)

{
    "id": "blockchain_payment_8888",
    "debtor":
    {
        "account_identifier":
        {
            "type": "wallet_address",
            "value": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
        },
        "chain": "base",
        "refund_wallet_address": "0xB9m86771c6218b36c1d19D4a2e9Eb0cE3606eB49",
        "funding_instructions":
        {
            "from_wallet_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "chain": "base",
            "amount": 1000000,
            "currency_code": "USDC",
            "to_wallet_address": "0x022e3fD8662c84AF51fF06d7DcAe0b675416dab4"
        },
        "entity_id": "entity_67890"
    },
    "creditor":
    {
        "payment_rail": "spei",
        "clabe":
        {
            "account_number": "00218090010000001234"
        },
        "type": "business",
        "business":
        {
            "business_name": "Acme Mexico SA de CV"
        },
        "address":
        {
            "line_one": "Av. Reforma 123",
            "city": "Ciudad de México",
            "country": "MX",
            "postal_code": "06600"
        }
    },
    "creditor_agent":
    {
        "bank_name": "BBVA México",
        "country_code": "MX"
    },
    "amounts":
    {
        "instructed_amount": 1000000,
        "instructed_currency_code": "USDC",
        "settlement_currency_code": "MXN",
        "settlement_amount": 17461350,
        "settlement_exchange_rate": 1746
    },
    "payment_purpose":
    {
        "type": "invoice_payment"
    },
    "reference": "INV-MXN-2026-001",
    "status": "created",
    "created_at": "2026-02-24T11:22:33Z",
    "updated_at": "2026-02-24T11:22:33Z"
}

⌘I