chatformdocs
API referenceV1

Start connecting a Cashfree or Razorpay account

Returns the gateway's consent URL. It must be opened in a browser signed in to chatform as the user who created this key; the state is single-use and expires in ten minutes. `returnTo` must be a page on the chatform app.

POST
/v1/payment-accounts/oauth/{provider}/start

Authorization

AuthorizationBearer <token>

A server-side secret key. Never send one from a browser — a request carrying an Origin header is refused for this reason.

In: header

Path Parameters

provider*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/payment-accounts/oauth/string/start" \  -H "Content-Type: application/json" \  -d '{    "returnTo": "string"  }'
{  "url": "string"}

Create a Cashfree account for a business that has none

Returns the Cashfree KYC link, or `{ useOAuth: true }` when the email already has a Cashfree account.

Connect a Stripe account with a restricted key

Accepts only a restricted key (`rk_test_…` or `rk_live_…`); a full `sk_` secret key is refused with `full_secret_key`. The key is checked by reading the account, creating and immediately expiring a Checkout Session, and creating a webhook endpoint — a missing permission comes back as `missing_permission` with the permission named.