Register Payin Transaction Hash

POST

/payments/{paymentId}/payin

Tell Rozo the on-chain transaction the buyer just submitted.
Optional — Rozo also detects payins on its own via Alchemy
webhooks (EVM) and Stellar Horizon (Stellar). Calling this
endpoint just speeds up confirmation, especially on Stellar where
we can verify the tx through Horizon in ~5 seconds.

Pass txHash and the buyer's fromAddress. We store both and
kick off verification immediately.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Payin registered. Verification continues asynchronously.

Bodyapplication/json

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://intentapiv4.rozo.ai/functions/v1/payment-api/payments/550e8400-e29b-41d4-a716-446655440000/payin' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "txHash": "0xabc123...",
    "fromAddress": "0xdef456..."
}'

Response Example

200 - Example 1

{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "appId": "string",
    "orderId": "string",
    "errorCode": "string",
    "errorMessage": "string",
    "createdAt": "2019-08-24T14:15:22.123Z",
    "updatedAt": "2019-08-24T14:15:22.123Z",
    "expiresAt": "2019-08-24T14:15:22.123Z",
    "webhookSecret": "string",
    "metadata": {},
    "status": "payment_unpaid",
    "type": "exactIn",
    "display": {
        "title": "string",
        "description": "string",
        "currency": "string"
    },
    "destination": {
        "chainId": "string",
        "receiverAddress": "string",
        "receiverMemo": "string",
        "tokenSymbol": "string",
        "tokenAddress": "string",
        "amount": "string",
        "txHash": "string",
        "confirmedAt": "2019-08-24T14:15:22.123Z"
    },
    "source": {
        "chainId": "string",
        "tokenSymbol": "string",
        "tokenAddress": "string",
        "amount": "string",
        "receiverAddress": "string",
        "receiverMemo": "string",
        "fee": "string",
        "senderAddress": "string",
        "txHash": "string",
        "amountReceived": "string",
        "confirmedAt": "2019-08-24T14:15:22.123Z"
    }
}

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

Get Payment by Order ID

List Payments