Statuses & Events - Lead | API Docs

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

Global Money Movement Page 1 (56)

Funding Source: Stablecoins Outside of Lead

Global Money Movement Page 1 (55)

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.

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"
    }
}

⌘I