v6

OpenAPI 3.1.12026-08-027636.5 MB

PaymentRequests

Fulfill payment request

Fulfill an open payment request from a wallet or a verified linked bank account

post/payment-requests/{paymentRequestId}/fulfill

Path parameters

paymentRequestIdstring required

Payment request ID (prq_*).

Headers

Idempotency-Keystring required

Unique key for safely retrying a request without creating duplicates.

X-Agent-IDstring nullable

Agent (agt_*) to attribute this request to when authenticating with a party API key; omit for agent keys and agent-scoped OAuth grants, which already carry agent identity.

X-Instance-IDstring nullable

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

Request body

partyIdstring

Effective payer party ID (pty_*) for delegated payment request fulfillment.

Response

Successful Response