PaymentRequests
Create payment request
Create a payment request. Natural notifies the payer directly: email and phone payers receive the pay link, on-platform parties receive a dashboard deep-link, and agent and handle payers receive only the in-app webhook.
post/payment-requests
Headers
Idempotency-Keystring required
Unique key for idempotent request handling. If a request with the same key was already processed, the original response is returned.
X-Agent-IDstring nullable
Agent ID (agt_xxx) identifying which agent is making the request.
X-Instance-IDstring nullable
Required when X-Agent-ID is present. Session or conversation ID for agent observability.
Request body
Response
Successful Response