Skip to main content
POST
Add a gateway account

Authorizations

Authorization
string
header
required

Your API key, e.g. sk_live_... or sk_test_....

Headers

Idempotency-Key
string

Optional. Makes this write safe to retry: the same key replays the first response instead of acting twice.

Maximum string length: 255

Body

application/json
provider
enum<string>
required
Available options:
cashfree,
razorpay
label
string
required
Maximum string length: 80
credentials
object
required

Cashfree: client_id, client_secret. Razorpay: key_id, key_secret, webhook_secret.

is_sandbox
boolean
payment_configuration_name
string

Response

The gateway account.

Keys are never returned.

id
string<uuid>
provider
enum<string>
Available options:
cashfree,
razorpay
provider_label
string
label
string
key_hint
string | null
Example:

"••••a1b2"

is_sandbox
boolean
payment_configuration_name
string | null
methods
string[]
webhook_url
string<uri>

Add this in your gateway dashboard.

verified_at
string<date-time> | null
last_webhook_at
string<date-time> | null