Reference · v1

Merchant

Developer-facing merchant configuration/auth endpoints in the public spec.

Auth and sessions

POST/v1/merchant-auth/loginIssue bearer access token
POST/v1/merchant/auth/loginConsole login
POST/v1/merchant/auth/refreshRefresh console session
GET/v1/merchant/auth/meCurrent console session
POST/v1/merchant/auth/switch-environmentSwitch active environment
POST/v1/merchant/auth/totp/enrollment/startStart TOTP enrollment
POST/v1/merchant/auth/totp/enrollment/confirmConfirm TOTP enrollment
POST/v1/merchant/auth/logoutLogout
POST/v1/merchant/auth/change-passwordChange password
POST/v1/merchant/auth/forgot-passwordStart password reset
POST/v1/merchant/auth/reset-passwordComplete password reset

Merchant profile

GET/v1/merchant/meMerchant profile
GET/v1/merchant/principalCurrent principal/scopes
GET/v1/merchant/fee-planMerchant fee plan
PUT/v1/merchant/fee-planUpdate merchant fee plan

Settlement and payout settings

GET/v1/merchant/settlement-configList settlement config rows
PUT/v1/merchant/settlement-configCreate/update settlement config row
PUT/v1/merchant/settlement-config/set-primarySet primary settlement config
DELETE/v1/merchant/settlement-configDelete settlement config row
GET/v1/merchant/settlement-capabilitiesSettlement capabilities
GET/v1/merchant/settlement-preferenceGet settlement preference
PUT/v1/merchant/settlement-preferenceUpdate settlement preference
GET/v1/merchant/auto-fiat-payout-settingsGet auto fiat payout settings
PUT/v1/merchant/auto-fiat-payout-settingsUpdate auto fiat payout settings
GET/v1/merchant/fiat/corridorsList fiat corridors
POST/v1/merchant/fiat/institutionsList fiat institutions
POST/v1/merchant/fiat/beneficiary/resolveResolve fiat beneficiary

API credentials

GET/v1/merchant/api-credentialsList API credentials (includes allowed_ips)
POST/v1/merchant/api-credentialsCreate API credential (optional allowed_ips, email_otp_code)
PUT/v1/merchant/api-credentials/{credentialId}/ip-allowlistUpdate IP allowlist (?environment required)
POST/v1/merchant/api-credentials/{credentialId}/revokeRevoke credential
POST/v1/merchant/api-credentials/{credentialId}/rotateRotate credential

Email OTP (sensitive actions)

GET/v1/merchant/security/email-otp/statusWhether email OTP step-up is enabled
POST/v1/merchant/security/email-otp/sendSend 6-digit code (purpose: payout | settlement_preference | bank_account | api_key_ip_allowlist)

Payout OTP and users

GET/v1/merchant/usersList merchant users
POST/v1/merchant/usersCreate merchant user
GET/v1/merchant/payout-otp/statusPayout OTP status
POST/v1/merchant/payout-otp/enrollment/startStart payout OTP enrollment
POST/v1/merchant/payout-otp/enrollment/confirmConfirm payout OTP enrollment
GET/v1/merchant/deposit-rules-defaultGet default deposit rules
PUT/v1/merchant/deposit-rules-defaultUpdate default deposit rules

This page intentionally excludes internal admin/operator APIs.