Create a one-off payment

Pulls amount of tokenKey from fromWallet and forwards it to toWallet. idempotencyKey is required. See Core concepts → Payments.

Authorization

apiKey

X-API-Key<token>

Your merchant API key, shown once at creation in the dashboard (Settings → API key).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

paymentMethod?string

"wallet_connect" (default) pulls from fromWallet, which must already have granted the operator an allowance covering amount. "wallet_transfer" instead returns a dedicated deposit address for the payer to send to manually — no allowance, and fromWallet must be omitted.

Default"wallet_connect"

Value in

"wallet_connect"
"wallet_transfer"

fromWallet?|

The wallet funds are pulled from. Required for wallet_connect and must have an existing on-chain allowance; must be OMITTED for wallet_transfer, where the payer's wallet is unknown in advance.

toWallet*|

Where the funds are forwarded — your own wallet, or any third party you are paying out. Must match the chain family of tokenKey. Tidepay never takes custody; the operator only holds funds mid-transaction.

amount*string

Decimal string in tokenKey's own units — this is a direct token amount, not a fiat price, so no conversion happens. Minimum 1.00.

Match^\d+(\.\d+)?$

tokenKey*string

Which chain+token to move, as a catalog key from GET /v1/currencies.

Value in

"usdc-polygon"
"usdt-polygon"
"usdc-arbitrum"
"usdt-arbitrum"
"usdc-base"
"eurc-base"
"usdc-optimism"
"usdt-optimism"
"usdc-base-sepolia"
"usdc-solana"
"usdt-solana"
"eurc-solana"
"usdc-solana-devnet"

idempotencyKey*string

REQUIRED here, unlike elsewhere: this endpoint moves money synchronously, so a blind retry without a key could double-pull. Reusing a key returns the original payment instead of charging again.

Length1 <= length <= 200

Response Body

`application/json`

curl -X POST "https://example.com/payments" \  -H "Content-Type: application/json" \  -d '{    "toWallet": "string",    "amount": "25.00",    "tokenKey": "usdc-polygon",    "idempotencyKey": "550e8400-e29b-41d4-a716-446655440000"  }'

{  "id": "pay_01j8x2q3r4s5t6u7v8w9x0y1z2",  "merchantId": "string",  "customerId": "string",  "source": "one_time",  "subscriptionId": "string",  "offerId": "string",  "priceId": "string",  "periodStart": "2026-08-19T14:32:00.000Z",  "periodEnd": "2026-08-19T14:32:00.000Z",  "attempts": 1,  "idempotencyKey": "string",  "paymentMethod": "wallet_connect",  "fromWallet": "0x71c7656ec7ab88b098defb751b7401b5f6d8976",  "toWallet": "0x71c7656ec7ab88b098defb751b7401b5f6d8976",  "amount": "10.00",  "platformAmount": "10.00",  "merchantAmount": "10.00",  "tokenKey": "usdc-polygon",  "chainId": 137,  "pullTxHash": "string",  "forwardTxHash": "string",  "platformTransferTxHash": "string",  "distributeTxHash": "string",  "status": "pending",  "failureReason": "insufficient_allowance",  "isSandbox": true,  "affiliatePartnerId": "string",  "affiliateCommissionPct": "string",  "createdAt": "2026-08-19T14:32:00.000Z",  "updatedAt": "2026-08-19T14:32:00.000Z"}

Create a one-off payment

Authorization

Request Body

Response Body

200application/json

201application/json

400application/json

401application/json

409application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`