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 verified 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). Optional headers x-api-key, Authorization: Bearer, or api-key are also accepted on some flows.

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

Operation	Debits credit?
`getCreditsLeft`	No
`payment`	No (debit on payment start)
`StartPayment` / `start*Payment`	Yes (owner key)
Other API-key operations	Yes

Credit top-ups are managed via the dashboard (UserCreateCreditTopup, UserStartCreditTopup) — not the legacy rechargeApiKey flow.

Verified REST map

REST	GraphQL
`GET /health`	Service health check
`POST /create-payment`	`payment`
`POST /pay`	`StartPayment` / `start*Payment` / `UserStartCreditTopup`
`GET /orders/:txnid`	`getTxnDetails`
`GET /txn/:txnid`	`getTxnDetails`
`GET /donate/:campaignId`	`getDonate`
`POST /donate/:campaignId/pay`	`StartDonation`

cancelPayment is GraphQL-only. Dashboard User* operations require a Bearer session token — see API schema.

Transaction statuses

PENDING · STARTED · COMPLETED · EXPIRED · CANCELLED

Typical payment flow

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