Skip to main content
POST
Complete payment claim
Completes a payment held for the claim recipient, as if the payee just joined Natural and received the funds. From the Sandbox MCP server, use create_payment with payment-claim@sandbox.natural.test, then pass the returned payment ID to simulate_payment_claim_completion.

Authorizations

Authorization
string
header
required

Bearer authentication: send your API key, agent key, or OAuth access token as Authorization: Bearer <credential>.

Headers

X-Agent-ID
string | null

Deprecated: agent identity comes from the credential. Sending this header with a party API key or user credential returns 403 agent_credential_required.

Maximum string length: 36
Pattern: ^agt_[0-9a-f]{32}$
X-Instance-ID
string | null

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Maximum string length: 1024

Path Parameters

paymentId
string
required
Pattern: ^pay_[0-9a-f]{32}$

Response

Successful Response

data
PaymentResource · object
required