POST /v1/payments/webhooks/{provider}
CheckoutService_HandlePaymentWebhook
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
providerpath · string · required
Request body
amountstringcurrencystringevent_idstringevent_typestringnoncestringoccurred_atstringpayload_jsonstringpayment_connection_idstringEnvironment-scoped provider webhook routes include this stable ID so signature verification uses the same connection as the payment intent.
providerstringprovider_intent_idstringprovider_transaction_idstringserialstringsignaturestringtimestampstring
cURL
curl --request POST 'https://nexus-api.rainlib.com/v1/payments/webhooks/{provider}' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"amount": "<value>",
"currency": "<value>",
"event_id": "<value>",
"event_type": "<value>",
"nonce": "<value>",
"occurred_at": "<value>",
"payload_json": "<value>",
"payment_connection_id": "<value>",
"provider_intent_id": "<value>",
"provider_transaction_id": "<value>",
"serial": "<value>",
"signature": "<value>",
"timestamp": "<value>"
}'Response contract
200 · OK
acceptedbooleanduplicatebooleanorder_idstringstatusstring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.