Create payment request
Payment Requests
Create payment request
Create a payment request. Natural notifies the payer directly — email/phone payers receive the pay link, on-platform parties receive a dashboard deep-link, and agent payers receive only the in-app webhook.
POST
Create payment request
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Unique key for idempotent request handling. If a request with the same key was already processed, the original response is returned.
Agent ID (agt_xxx) identifying which agent is making the request.
Required when X-Agent-ID is present. Session or conversation ID for agent observability.
Maximum string length:
1024Body
application/json
Resource object
Response
Successful Response