Skip to main content
POST
Create an integrator
Create a new integrator account to start using the Kotani Pay API platform.

Body

application/json
organization
string
required

organization

Example:

"A&B Company"

product_name
string
required

product name

Example:

"MY APP NAME"

first_name
string
required

first_name

Example:

"John"

last_name
string
required

last_name

Example:

"Doe"

email
string
required

email

Example:

"ab@gmail.com"

phone
string
required

phone

Example:

"+xxx xxx xxx xxx"

country_code
string
required

Country code (accepts ISO-2 or ISO-3, auto-converts to ISO-2)

Example:

"US or USA"

webhook_url
string

Default webhook callback URL

Example:

"https://example.com/kotani/webhooks"

webhook_secret
string

Shared secret used to sign webhook payloads

Example:

"whsec_xxx"

webhook_events
enum<string>[]

Webhook events this integrator is subscribed to

Available options:
transaction.status.updated,
transaction.deposit.status.updated,
transaction.withdrawal.status.updated,
transaction.onramp.status.updated,
transaction.offramp.status.updated,
payment.confirmed,
kyc.status.changed,
refund.lightning.invoice_needed,
system.event
Example:

Response

success
boolean
Example:

true

message
string
Example:

"The record has been successfully created."

data
object