API Reference

Cancel payment

Cancel a payment that has not already been finalized.

POSThttps://api.argonpay.app/graphqlcancelPayment

Cancels a payment that is not already finalized (completed, expired, or cancelled). Takes txnid only. GraphQL-only — there is no REST wrapper in v2.

If the custodian has a callbackUrl, a cancellation webhook may be sent.

Endpoint

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

Mutation

mutation CancelPayment($txnid: String!) {
  cancelPayment(txnid: $txnid) {
    code
    message
    transaction {
      txnid
      amount
      status
      network
      createdAt
    }
  }
}

Arguments

Name	Type	Required	Description
`txnid`	`String!`	Yes	Transaction ID to cancel

Example variables

{
  "txnid": "YOUR_TXNID"
}

Webhook preview

Preview callback payload

Argonpay POSTs JSON to your custodian callbackUrl when a payment completes, expires, or is cancelled. Adjust the fields below to see the exact body shape, then optionally send a test request to your endpoint.

Status StringSent after payment is detected and settlement processing finishes.txnid Stringamount FloatamountInToken Floatnetwork Stringsecret StringAlso sent as privateKey for legacy integrations.createdAt StringcallbackUrl StringYour server endpoint — used only when you click Send test webhook.

POST body preview

{
  "txnid": "demo-txn-abc123",
  "status": "completed",
  "amount": 25.5,
  "amountInToken": 25.5,
  "network": "polygon",
  "createdAt": "2026-07-13T17:22:58.995Z",
  "secret": "your-custodian-secret",
  "privateKey": "your-custodian-secret"
}

Cancel payment

curl --request POST \
  --url 'https://api.argonpay.app/graphql' \
  --header 'Content-Type: application/json' \
  --data '{"query":"mutation CancelPayment($txnid: String!) {\n  cancelPayment(txnid: $txnid) {\n    code\n    message\n    transaction {\n      txnid\n      amount\n      status\n      network\n      createdAt\n    }\n  }\n}","operationName":"CancelPayment","variables":{"txnid":"YOUR_TXNID"}}'

{
  "data": {
    "cancelPayment": {
      "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

Cancelled payment identifier.

transaction.amountFloat

Payment amount.

transaction.statusTransactionStatus

Updated status, typically CANCELLED.

transaction.networkNetwork

Network enum if already selected.

transaction.createdAtString

ISO-8601 creation timestamp.

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