API Reference

Start payment (unified)

Start monitoring a pending payment on any supported network with one mutation.

POSThttps://api.argonpay.app/graphqlStartPayment

Unified mutation to start a pending payment on any supported network. Requires either a Bearer session token (dashboard) or an optional apiKey that owns the transaction.

Debits 1 credit from the transaction owner's API key when started.

Endpoint

POST https://api.argonpay.app/graphql

Mutation

mutation StartPayment($txnid: String!, $network: Network!, $token: StableToken, $apiKey: String) {
  StartPayment(txnid: $txnid, network: $network, token: $token, apiKey: $apiKey) {
    code
    message
    transaction {
      txnid
      amount
      amountInToken
      token
      network
      status
      wallet { address }
      custodianBranding { tagline brandColor logoUrl }
      countdown
      expiresAt
      createdAt
    }
  }
}

Arguments

Name	Type	Required	Description
`txnid`	`String!`	Yes	Pending transaction ID
`network`	`Network!`	Yes	`BEP20`, `POLYGON`, `BASE`, or `SOL`
`token`	`StableToken`	No	`USDT` or `USDC` (EVM only)
`apiKey`	`String`	No	Merchant API key when not using Bearer auth

REST equivalent

See Start payment. Pass apiKey in the body or Authorization: Bearer to use this unified path; omit auth for public hosted-checkout starters.

Start payment (unified)

curl --request POST \
  --url 'https://api.argonpay.app/graphql' \
  --header 'Content-Type: application/json' \
  --data '{"query":"mutation StartPayment($txnid: String!, $network: Network!, $token: StableToken, $apiKey: String) {\n  StartPayment(txnid: $txnid, network: $network, token: $token, apiKey: $apiKey) {\n    code\n    message\n    transaction {\n      txnid\n      amount\n      network\n      status\n      wallet { address }\n      expiresAt\n    }\n  }\n}","operationName":"StartPayment","variables":{"txnid":"YOUR_TXNID","network":"BEP20","token":"USDT","apiKey":"YOUR_API_KEY"}}'

{
  "data": {
    "StartPayment": {
      "code": 200,
      "message": "OK"
    }
  }
}

Response fields

Types for values returned by this operation.

codeInt

HTTP-style status code for the operation result.

messageString

Human-readable result message.

transaction.txnidString

Unique payment / order identifier.

transaction.amountFloat

Requested payment amount.

transaction.amountInTokenFloat

Amount denominated in the selected token, when started.

transaction.tokenString

Stable token symbol such as USDT or USDC.

transaction.networkNetwork

Selected chain enum: BEP20, POLYGON, BASE, or SOL.

transaction.statusTransactionStatus

PENDING, STARTED, COMPLETED, EXPIRED, or CANCELLED.

transaction.wallet.addressString

Deposit address for the payment.

transaction.countdownInt

Seconds remaining before expiry, when available.

transaction.hashString

On-chain transaction hash after payment detection.

transaction.blockchainLinkString

Explorer URL for the payment transaction.

transaction.isExpiredBoolean

Whether the payment window has expired.

transaction.expiresAtString

ISO-8601 expiry timestamp.

transaction.createdAtString

ISO-8601 creation timestamp.

POST · https://api.argonpay.app/graphql