POST /v1/refunds
CheckoutService_CreateRefund
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
amountstringidempotency_keystringorder_idstringreasonstring
cURL
curl --request POST 'https://nexus-api.rainlib.com/v1/refunds' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"amount": "<value>",
"idempotency_key": "<value>",
"order_id": "<value>",
"reason": "<value>"
}'Response contract
200 · OK
amountstringcompleted_atstringcreated_atstringcurrencystringcustomer_account_idstringeffects_statusstringidstringmodestringorder_idstringproviderstringprovider_refund_idstringreasonstringrecovery_statestringstatusstring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.