POST /v1/payments/intents
CheckoutService_CreatePaymentIntent
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
No path or query parameters.
Request body
idempotency_keystringorder_idstringproviderstringreturn_urlstring
cURL
curl --request POST 'https://nexus-api.rainlib.com/v1/payments/intents' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"order_id": "<order.id>",
"provider": "STRIPE",
"return_url": "https://app.example.com/orders",
"idempotency_key": "<payment-action-key>"
}'Response contract
200 · OK
amountstringcheckout_urlstringcreated_atstringcurrencystringcustomer_account_idstringexpires_atstringfailure_codestringfailure_messagestringgateway_modestringImmutable money boundary captured when the intent is created.
idstringorder_idstringpayment_connection_idstringActivated environment connection selected when this intent was created. Empty identifies a legacy deployment-level provider configuration.
providerstringprovider_intent_idstringprovider_price_idstringstatusstringupdated_atstring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.