Get Payment

GET

/payments/{paymentId}

Retrieves a payment by ID.

Optional auth: if X-API-Key is supplied, the payment must
belong to the key's app_id, otherwise 404 (cross-tenant defense).
Without a key, any payment id is fetchable (legacy contract).

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Path Params

Responses

🟢200

application/json

Payment found

Bodyapplication/json

🟠400

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://intentapiv4.rozo.ai/functions/v1/payment-api/payments/550e8400-e29b-41d4-a716-446655440000'

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:37

Create Payment