Appearance
Cards partner API
Use the cards partner API to issue cards for your customers, manage their spending, and move collateral through your treasury. Your integration runs on your server with credentials supplied by Agio.
Start with your first signed request, then follow onboarding to create a cardholder and submit an application.
Endpoint
| Environment | GraphQL endpoint |
|---|---|
| Development | https://dev.api.agiodigital.com/partner/cards/graphql |
| Production | https://api.agiodigital.com/partner/cards/graphql |
Credentials belong to one environment. Ask your Agio account manager for an API token, a signing secret, and the card program configuration. If Agio will manage collateral for you, your partner treasury must also be configured.
What this API exposes
Use the partner endpoint for card operations and record queries, and sign each request. Queries such as AgioCard_card_application and AgioCard_vw_card return stored card data. Operations such as createCard issue cards; cardBalance reads the cardholder's current spending balance.
Your API key determines your partner organization. Reads and operations are scoped to the customer organizations you manage. You cannot choose another partner organization in a request.
| Task | Guide |
|---|---|
| Make a signed request and check credentials | Quickstart |
| Sign requests, inspect the schema, or rotate credentials | Authentication |
| Provision a cardholder, collect consent, and submit an application | Onboarding |
| Issue, freeze, replace, or reveal a card | Cards |
| Deposit funds, fund from treasury, or withdraw collateral | Funding |
| Read wallet balances and send a batch of transfers | Wallets and multisend |
| Receive status changes and transactions | Webhooks |
| Handle errors, throttling, and uncertain outcomes | Errors and retries |
Operation reference
Open the endpoint in a browser for GraphiQL, or use the partner API reference for input and response types. The live schema shows the read fields available to your integration.
| Area | Operations |
|---|---|
| Onboarding | createPartnerCustomerOrganization, createPartnerCardUser, patchPartnerCardUser, createCardApplicationForPartnerUser |
| Card lifecycle | createCard, freezeCard, unfreezeCard, cancelCard, replaceCard, replaceVirtualCard |
| Card settings and secrets | updateCardNickname, updateCardLimit, generateEncryptionKeys, setCardPin, getCardPin, revealCardSecrets |
| Profile and addresses | updateCardUserProfile, updateCardCompanyAddress, validateAddress, validateCardShippingAddress, autocompleteAddress, resolvePlaceAddress |
| Balances and collateral | cardBalance, cardFundSubClientFromTreasury, cardFundSubClientStatus, cardWithdrawForPartner |
| Wallet transfers | multiSendFromWallet, multiSendJobStatus |
| Webhooks | subscribePartnerWebhook, unsubscribePartnerWebhook, rotatePartnerWebhookSecret, resendPartnerWebhookDelivery |
Use freezeCard and unfreezeCard in new integrations; lockCard and unlockCard are compatibility aliases. Contact Agio before implementing corporate applications.