Statuses & Events

Statuses

Status	Description	Webhook Event
`created`	Payment initiated in Lead’s system.	`.payment_created`
`under_review`	Payment flagged for manual review by compliance.	`.payment_under_review`
`awaiting_funds`	Waiting for stablecoins to arrive (external wallet source only).	`.payment_awaiting_funds`
`submitted`	Funds transferred to destination, settlement in progress.	`.payment_submitted`
`posted`	Settlement complete, funds delivered to destination.	`.payment_posted`
`rejected`	Payment rejected by Lead or partner; funds reversed.	`.payment_rejected`
`canceled`	Payment canceled by Lead or customer.	`.payment_canceled`

Funding Source: USD at Lead

Funding Source: Stablecoins Outside of Lead

Events

Event	Description
`.payment_created`	Lead creates the blockchain payment object.
`.payment_under_review`	Compliance flags the payment for manual review. Lead either rejects the payment or clears it to continue.
`.payment_awaiting_funds`	The payment stays in this status until the funds arrive in the Lead wallet. Only valid in the case of the source of `debtor.account_identifier.type: wallet_address`.
`.payment_submitted`	Lead submits the payment.
`.payment_posted`	The payment posts and the funds arrive in the destination account or wallet.
`.payment_rejected`	Lead or its partners reject the payment.
`.payment_canceled`	Lead cancels the payment when the funds never arrive.

Returns

A payment Lead submits successfully can still come back — for example, when the receiving account is closed. Lead credits the funds to the debtor and records the return on two payment objects: the original payment, and a new return payment carrying the funds back. The original payment settles at posted. There is no separate returned status, so read the return object to tell a delivered payment from a returned one.

Field	Where It Appears	Description
`return.code`	Original payment and return payment	Machine-readable reason for the return: `account_closed` or `payment_returned`.
`return.reason`	Original payment and return payment	Description of the same reason, for display to your customer.
`related_blockchain_payments.return_blockchain_payment_ids`	Original payment	The return payments carrying the funds back.
`related_blockchain_payments.original_blockchain_payment_id`	Return payment	The payment the funds come back for.

The return payment carries payment_purpose.type: return and moves straight to posted. The return purpose is response-only; Lead rejects a create request that sends it. Lead sends a .payment_created webhook for the return payment, followed by .payment_posted. Retrieve the return payment with Retrieve a Blockchain Payment, using the ID from related_blockchain_payments. The list endpoint omits return payments.

Awaiting Funds Webhook Payload

If the status of the payment changes to awaiting_funds, the object includes a funding_instructions section with the details of where to send the funds. See the object definition above for the details of the funding_instructions property.

{
    "id": "event_12345",
    "created_at": "2026-02-24T11:22:33Z",
    "event": "blockchain.payment_awaiting_funds",
    "object":
    {
        "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": "awaiting_funds",
        "created_at": "2026-02-24T11:22:33Z",
        "updated_at": "2026-02-24T11:22:33Z"
    }
}

Example Webhook Payload for Other Events

Funding instructions are not relevant to any other status, so all other events omit them.

{
    "id": "event_12345",
    "created_at": "2026-02-24T11:22:33Z",
    "event": "blockchain.payment_posted",
    "object":
    {
        "id": "blockchain_payment_8888",
        "debtor":
        {
            "identifier":
            {
                "type": "wallet_address",
                "value": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
            },
            "chain": "base",
            "refund_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",
            "address":
            {
                "line_one": "Av. Paseo de la Reforma 505",
                "city": "Ciudad de México",
                "country": "MX",
                "postal_code": "06500"
            }
        },
        "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": "posted",
        "created_at": "2026-02-24T11:22:33Z",
        "updated_at": "2026-02-24T11:22:33Z"
    }
}

Banking Infrastructure

Lending & Receivables

Payment Rails

Customers & Accounts

Network Settlement

Statuses

Funding Source: USD at Lead

Funding Source: Stablecoins Outside of Lead

Events

Returns

Awaiting Funds Webhook Payload

Example Webhook Payload for Other Events

​Statuses

​Funding Source: USD at Lead

​Funding Source: Stablecoins Outside of Lead

​Events

​Returns

​Awaiting Funds Webhook Payload

​Example Webhook Payload for Other Events

Statuses

Funding Source: USD at Lead

Funding Source: Stablecoins Outside of Lead

Events

Returns

Awaiting Funds Webhook Payload

Example Webhook Payload for Other Events