API Reference

Create custodian account

POSThttps://api.argonpay.app/graphqlcreateCustodianAccount

Registers custodian settlement settings for your API key (one custodian per key). Debits 1 credit.

Use the CustodianCreateInput input type.

Endpoint

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

Mutation

mutation CreateCustodianAccount($input: CustodianCreateInput!) {
  createCustodianAccount(input: $input) {
    code
    message
    custodian {
      id
      apiKey
      wallets {
        bep20
        polygon
        base
        solana
      }
      callbackUrl
      createdAt
    }
    apiKey {
      key
      creditsLeft
    }
  }
}

Input fields

Name	Type	Required	Description
`apiKey`	`String!`	Yes	Your API key
`wallets`	`CustodianWalletsInput`	No	Public settlement addresses
`wallets.bep20`	`String`	No	BEP20 settlement address
`wallets.polygon`	`String`	No	Polygon settlement address
`wallets.base`	`String`	No	Base settlement address
`wallets.solana`	`String`	No	Solana settlement address
`callbackUrl`	`String`	No	HTTPS webhook URL for payment notifications
`secret`	`String`	No	Callback signing secret
`name`	`String`	No	Custodian display name
`networks`	`[CustodianNetworkInput!]`	No	Per-chain pay/gas configuration
`branding`	`CustodianBrandingInput`	No	Checkout branding (tagline, colors, logo)

Example variables (public fields)

{
  "input": {
    "apiKey": "YOUR_API_KEY",
    "wallets": {
      "bep20": "0xYourBep20Address",
      "polygon": "0xYourPolygonAddress",
      "base": "0xYourBaseAddress",
      "solana": "YourSolanaAddress"
    },
    "callbackUrl": "https://merchant.example/webhooks/argonpay"
  }
}

Errors

Code	Meaning
401 / 402	Invalid key or credit limit
409	Custodian already exists for this API key

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:23:02.130Z",
  "secret": "your-custodian-secret",
  "privateKey": "your-custodian-secret"
}

Create custodian account

curl --request POST \
  --url 'https://api.argonpay.app/graphql' \
  --header 'Content-Type: application/json' \
  --data '{"query":"mutation CreateCustodianAccount($input: CustodianCreateInput!) {\n  createCustodianAccount(input: $input) {\n    code\n    message\n    custodian {\n      id\n      wallets {\n        bep20\n        polygon\n        base\n        solana\n      }\n      callbackUrl\n      createdAt\n    }\n    apiKey {\n      creditsLeft\n    }\n  }\n}","operationName":"CreateCustodianAccount","variables":{"input":{"apiKey":"YOUR_API_KEY","wallets":{}}}}'

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

custodian.idString

Custodian record identifier.

custodian.wallets.bep20String

BEP20 settlement address.

custodian.wallets.polygonString

Polygon settlement address.

custodian.wallets.baseString

Base settlement address.

custodian.wallets.solanaString

Solana settlement address.

custodian.callbackUrlString

Configured webhook URL.

custodian.createdAtString

ISO-8601 creation timestamp.

apiKey.creditsLeftInt

Remaining query balance after the call.

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