Skip to main content
A ready-made Postman collection that runs all three v2 flows end to end — connect, KYC, and wallet funding. Each request captures what the next one needs — the platform token, the connect id, the user id, the funding session id — so you can run them top to bottom without copy-pasting.

Download collection

agentcard-v2.postman_collection.json

Download environment

agentcard-v2.postman_environment.json

​
Set it up

1

Import both files

In Postman, Import → drop in the collection and the environment.
2

Select the environment

Pick Agentcard v2 in the environment dropdown (top right).
3

Add your credentials

Set client_id and client_secret on the environment to your Agentcard credentials. A sandbox client runs in sandbox; a production client runs in production.
4

Get a token

Run Get platform token once. It captures access_token, which every other request reuses automatically.

​
Run the flows

Connect — run in order:
  1. Start (email) — sends the code, saves connect_id.
  2. Verify — set verify_code to the code the user got, then run. Saves user_id and the connection tokens.
  3. Consent — records the authorization.
  4. Refresh — rotates the connection token.
In sandbox the code is always 111111 — the environment ships with verify_code preset to it, so Verify works with no change.
KYC — set id_image_base64 on the environment to a base64-encoded ID image, then run Upload front → Upload back. Follow the status the back upload returns: submit Submit information if it asks, then poll Get status. Wallet funding — run in order (needs a connected user_id from the Connect flow):
  1. Start phone verification — sends the funding code. Skip 1–2 if the response is already_verified.
  2. Verify the phone code — set verify_code to the code the user got.
  3. Create funding session — returns the Apple Pay / Google Pay checkout_url (logged to the console) and saves funding_session_id.
  4. Get funding session — poll until status is completed.
  5. Get wallet — the balance reflects the deposit.

​
Run it headless

Test the whole thing from the command line with Newman, Postman’s runner:

​
Variables