API Reference

Welcome

Overview of the Argonpay merchant GraphQL API and payment flow.

Argonpay is a multi-chain crypto payment API for merchants. This documentation covers merchant GraphQL operations and REST helpers from Argonpay v2.

Base URL

GraphQL: https://api.argonpay.app/graphql
REST: https://api.argonpay.app

Supported networks

Enum	Network
`BEP20`	BNB Smart Chain
`POLYGON`	Polygon
`BASE`	Base
`SOL`	Solana

Stable tokens: USDT, USDC (where supported by the payment start flow).

Authentication

API-key operations pass `apiKey` as a GraphQL argument (or in the REST body for POST /create-payment). There is no x-api-key header.

Checkout helpers such as start*Payment, cancelPayment, and getTxnDetails use `txnid` (from payment) instead of an apiKey argument. Starting a payment still debits 1 query from the transaction owner's key.

Operation	Debits query?
`getQueriesLeft`	No
`payment`	No (debit on payment start)
`rechargeApiKey`	No (adds queries)
`startBSCPayment` / `startPolygonPayment` / `startBasePayment` / `startSOLPayment`	Yes (owner key)
Other API-key operations	Yes

Merchant REST map

These REST routes wrap the same resolvers as the GraphQL operations below:

REST	GraphQL
`POST /create-payment`	`payment`
`POST /pay`	`startBSCPayment` / `startPolygonPayment` / `startBasePayment` / `startSOLPayment`
`POST /cancel-payment`	`cancelPayment`
`GET /orders/:txnid`	`getTxnDetails`

API-key, custodian, list, and admin-style operations are GraphQL-only in v2.

Transaction statuses

PENDING · STARTED · COMPLETED · EXPIRED · CANCELLED

Typical payment flow

payment (or POST /create-payment) → get txnid + paymentLink
start*Payment (or POST /pay) → deposit address
Poll getTxnDetails / GET /orders/:txnid (or getTransactionDetails with API key)
Optionally cancelPayment / POST /cancel-payment if still pending/started

Not documented here: subscriptions, superKey/admin tools, or public/guest payment flows.