Transactions

Create a payment transaction

post/transactions/create

Request

  • Base URL: https://api.griffnode.com/v1
  • URL: https://api.griffnode.com/v1/transactions/create
  • Auth: HTTP bearer

Headers

X-Idempotency-Keystring

Optional unique key for a create request (e.g. a UUID). A retried create with the same key returns the original transaction instead of creating a duplicate — send it on every create so a network retry can't double-charge the customer.

Request body

crypto'BTC' | 'LTC' | 'DOGE' | 'DASH' | 'ETH' | 'USDT' | 'USDC' | 'EURC' | 'DAI' | 'WBTC' | 'SHIB' | 'PEPE' | 'LINK' | 'UNI' | 'AAVE' | 'MKR' required

Supported coin/token symbol. /cryptos/list is authoritative at runtime.

amountnumber required

Fiat amount (≥ 1.00 USD equivalent).

currency_fiat'USD' | 'PLN' | 'EUR' | 'GBP'
metadataMetadata nullable

Free-form key/value (≤20 keys, string values ≤500 chars, ≤4 KB total).

customer_emailstring email nullable
success_urlstring uri nullable
cancel_urlstring uri nullable

Response

Transaction created.

successunknown required

Example response

{
  "data": {
    "transaction_id": "MTX-A1B2C3D4"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.