Skip to main content
Payment fixtures are synthetic counterparties visible only to your sandbox organization. They stand in for the recipient of your payment, the payer of your request, and the customer who authorizes your agents. For card numbers and card payment outcomes, see Card fixtures.

Send a payment

Pay any of these identifiers and your recipient fixture receives it:

Request a payment

Address a payment request to the payer fixture, then fulfill or decline it as the payer. The payer is always funded.

Pay someone who is not on Natural

Payments to these identifiers wait as claims, just as they would for a real person without a Natural account. Complete the claim, or call simulate_payment_claim_completion through MCP, to simulate the payee joining and receiving the funds.

Simulate Connect

Connect is how customers authorize your agents to act for them. Invite a test customer by choosing its agents. Natural creates the synthetic customer, visible only to your organization, and leaves one invitation PENDING for each agent; no customer contact details are required. Accept or decline each returned invitation as the test customer. After acceptance, fund the customer, pay on its behalf with customerPartyId, and revoke an agent to test per-agent revocation, or disconnect the customer when a test needs a clean slate. Revoking agents alone leaves the connection active.