Payin confirmed on the source chain

Webhook

POST

paymentPayinCompleted

Sent when the buyer's payin transaction is confirmed on the
source chain (status = payment_payin_completed). The data
block is the same Payment object returned by
GET /payments/{id} — match on data.id to reconcile against
your stored order.

At-most-once delivery; dedupe on event_id.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢2XX

Acknowledged. Any 2xx response is treated as delivered.

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://your-api-server.com' \
--header 'X-Rozo-Timestamp;' \
--header 'X-Rozo-Signature;' \
--header 'Content-Type: application/json' \
--data '{
    "event_id": "0a4f9b2e-1c2d-4e5f-8a6b-7c8d9e0f1a2b",
    "type": "payment_payin_completed",
    "timestamp": "2026-05-11T10:32:01Z",
    "data": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "orderId": "CAFE-1768921337803",
        "status": "payment_payin_completed",
        "source": {
            "chainId": "8453",
            "tokenSymbol": "USDC",
            "amount": "10.00",
            "txHash": "0xabc...",
            "amountReceived": "10.00",
            "confirmedAt": "2026-05-11T10:31:55Z"
        },
        "destination": {
            "chainId": "1500",
            "tokenSymbol": "USDC",
            "amount": "9.97",
            "receiverAddress": "GC56...",
            "txHash": null,
            "confirmedAt": null
        }
    }
}'

Modified at 2026-05-11 03:27:45

Payout confirmed on the destination chain

PaymentRequest