React Native

This is the wallet for React Native apps. It’s one component: you give it a wallet link, it renders the wallet, and you get the same events the web SDK fires.

Install

npm install @agentcard/wallet-react-native react-native-webview

The package is private while the SDK is in early access, so the install fails until your team has access. Write to us and we’ll set you up.

Create a wallet link (server side)

curl -X POST https://api.agentcard.sh/api/v2/wallet_links \
  -H "Authorization: Bearer $ORG_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "USER_ID"}'

const res = await fetch("https://api.agentcard.sh/api/v2/wallet_links", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${ORG_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ user_id: "USER_ID" }),
});
const link = await res.json();

import requests

res = requests.post(
    "https://api.agentcard.sh/api/v2/wallet_links",
    headers={"Authorization": f"Bearer {ORG_TOKEN}"},
    json={"user_id": "USER_ID"},
)
link = res.json()

The response includes a url. Hand it to your app. Links expire after 15 minutes by default (expires_in accepts 60 to 86400 seconds).

Render the wallet

import { AgentcardWallet } from "@agentcard/wallet-react-native";

<AgentcardWallet
  link={walletLinkUrl}
  onSuccess={(data) => {
    // data.type is "card_attached" or "payment_completed"
  }}
  onTokenExpired={() => {
    // fetch a fresh wallet link from your server and swap the `link` prop
  }}
/>

To ask for a payment instead of opening the wallet home:

<AgentcardWallet
  link={walletLinkUrl}
  pay={{ amountCents: 500, merchant: "Amazon" }}
  onSuccess={(data) => {}}
/>

The component accepts link as either the full URL or the raw token. onEvent(name, data) receives every bridge event if you want analytics, and style sizes the view.

Webhooks you will receive

Component events are UI signals. Your server should trust webhooks:

connected_card.updated when the user adds a card
transaction.* events when payments happen

When it fails

When the link or its session dies, onTokenExpired fires: create a fresh wallet link and swap the link prop. Bank approvals open in the system browser by default; override that with onOpenUrl(url) if you want an in-app browser. Passkey prompts need iOS 17 or later inside a WebView, so older devices fall back to code verification.

Sandbox behavior

With sandbox credentials, the connect code is always 111111 and the test card is 4242 4242 4242 4242 with any future expiry and any CVC. No real money moves. Next: Connect users

Get started

The wallet

Platforms

Purchase

Tools

Ship

Install

Create a wallet link (server side)

Render the wallet

Webhooks you will receive

When it fails

Sandbox behavior

​Install

​Create a wallet link (server side)

​Render the wallet

​Webhooks you will receive

​When it fails

​Sandbox behavior

Install

Create a wallet link (server side)

Render the wallet

Webhooks you will receive

When it fails

Sandbox behavior