Tidepay API Docs

Create a one-off charge

POST
/charges

Pulls amount of tokenKey from fromWallet (which must have already approved the operator's allowance) and forwards it to toWallet — your own merchant wallet, or any other address, e.g. to pay out a third party. idempotencyKey is required; replaying the same key returns the original charge instead of pulling twice. The response reflects the final settled/failed outcome, not just an initial pending state.

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.

Response Body

curl -X POST "https://example.com/charges" \  -H "Content-Type: application/json" \  -d '{    "toWallet": "string",    "amount": "string",    "tokenKey": "usdc-polygon",    "idempotencyKey": "string"  }'
Empty