POST /v1/payment-connections
CheckoutService_CreatePaymentConnection
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
api_secret_refstringcodestringenvironment_idstringidempotency_keystringmerchant_account_idstringmodestringnamestringproviderstringwebhook_secret_refstring
cURL
curl --request POST 'https://nexus-api.rainlib.com/v1/payment-connections' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"api_secret_ref": "<value>",
"code": "<value>",
"environment_id": "<value>",
"idempotency_key": "<value>",
"merchant_account_id": "<value>",
"mode": "<value>",
"name": "<value>",
"provider": "<value>",
"webhook_secret_ref": "<value>"
}'Response contract
200 · OK
api_secret_refstringcodestringcreated_atstringenvironment_idstringidstringlast_probe_atstringlast_probe_statusstringmerchant_account_idstringmodestringnamestringproviderstringstatusstringupdated_atstringvalidation_reportarrayExpand fields
codestringdetailstringlevelstringpassedbooleantitlestring
versionstringwebhook_secret_refstring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.