Create Payment

POST

/payment-api

Creates a new payment request.
Use case Alice send 100 USDC Base. Bob receive $99.9 USDC Stellar.

type = exactOut if Bob wants to receive exact $100.

There might be a min pay in amount (e.g. $1 for USDT / USDC ethereum )

please check ask for appid and jwt for login

webhook is not supported.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Payment created successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠409Conflict

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/payment-api' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "app_123",
    "orderId": "order_12345",
    "type": "exactIn",
    "display": {
        "title": "Order #12345",
        "currency": "USD"
    },
    "source": {
        "chainId": "8453",
        "tokenSymbol": "USDC",
        "amount": "1.00"
    },
    "destination": {
        "chainId": "1500",
        "receiverAddress": "GDFLZTLVMLR3OVO4VSODYB7SGVIOI2AS652WODBCGBUQAMXXXXXXXXXX",
        "tokenSymbol": "USDC"
    },
    "webhookUrl": "https://your-domain.com/webhook"
}'

Response Example

201 - Example 1

{
    "id": "pay_abc123",
    "appId": "app_123",
    "orderId": "order_12345",
    "status": "payment_unpaid",
    "errorCode": "insufficientLiquidity",
    "type": "exactIn",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "expiresAt": "2019-08-24T14:15:22Z",
    "display": {
        "title": "Order #12345",
        "description": "string",
        "currency": "USD"
    },
    "source": {
        "chainId": "1",
        "tokenSymbol": "ETH",
        "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "amount": "100.00",
        "receiverAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "receiverMemo": "string",
        "fee": "0.10",
        "senderAddress": "string",
        "txHash": "string",
        "amountReceived": "string",
        "confirmedAt": "2019-08-24T14:15:22Z"
    },
    "destination": {
        "chainId": "1",
        "receiverAddress": "GDFLZTLVMLR3OVO4VSODYB7SGVIOI2AS652WODBCGBUQAMKQL6O3QYPU",
        "receiverMemo": "string",
        "tokenSymbol": "ETH",
        "tokenAddress": "string",
        "amount": "99.90",
        "txHash": "string",
        "confirmedAt": "2019-08-24T14:15:22Z"
    },
    "webhookSecret": "a1b2c3d4e5f6...",
    "metadata": {}
}

Modified at 2025-12-02 02:20:19

Payments

Get Payment