Connect Your own agent to Pink Agentic AI Payments

What you get

Your own agent asks Pink before it pays

Once connected, Your own agent can see its budget, the payees it may pay and the rules that apply, run a dry run, request a payment and file the receipt. The rules you set in Pink decide each request: allowed on the spot, sent to a person on the phone, or blocked. Your own agent never holds a card number or a bank login.

Step by step

1. 1

   Create a free sandbox workspace

   Open agentic-sandbox.pinkwallet.com, type a company name, pick a template (coffee shop, startup or e-commerce) and click Create workspace. You get an admin key for the console and one key per AI agent. Keep the admin key: the sign-in page asks for it.

   

2. 2

   Copy an agent key

   From the workspace page or the console.

   

3. 3

   Connect a Streamable HTTP client

   Create the SDK's Streamable HTTP client transport for https://agentic-sandbox.pinkwallet.com/mcp with the Authorization header, list the tools, and call pink.request_payment. This exact loop is the sandbox's own test.
4. 4

   Or use REST

   If you would rather not speak MCP, every tool has a REST twin under /v1: POST /v1/payments/check, POST /v1/payments, GET /v1/payments/{id}, POST /v1/payments/{id}/receipt.
5. 5

   Watch the approval land in the console

   Open the sandbox console (link on the workspace page). Requests that cleared, asked a person or were blocked are all listed with the rule that decided them. Approve the pending one and the agent continues.

   

The configuration, ready to paste

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const pink = new Client({ name: 'purchasing-agent', version: '1.0.0' });
await pink.connect(new StreamableHTTPClientTransport(new URL('https://agentic-sandbox.pinkwallet.com/mcp'),
  { requestInit: { headers: { Authorization: 'Bearer <agent_key>' } } }));
const r = await pink.callTool({ name: 'pink.request_payment', arguments: { payee_id: 'p_cc', amount: 420, purpose: '20 kg espresso beans', idempotency_key: 'order-2291' } });
console.log(JSON.parse(r.content[0].text).decision); // allowed · pending_human · blocked

Replace <agent_key> with the key of the agent this sdk should act as. Each agent has its own key, budget and rules.

Try it: say this to Your own agent

Pink's side, in three screens

FAQ

Official documentation

• Model Context Protocol: SDKs ↗
• Pink: MCP tools reference
• Pink: the seven MCP tools, with real responses
• Pink: security model (what the client can and cannot reach)

Menu names and settings paths follow each vendor's documentation at the verified date. If a vendor moves a menu, the linked page is the source of truth; the Pink side does not change.

Other clients