APIInstall Merchant Account

Install Merchant Account

Install a new payment method provider for a project.

POST/v2/projects/{project_id}/merchant-accounts

Authorization

Bearer TokenRequired

Path Parameters

project_idstringRequired

The unique identifier of the project.

Request Body

providerstringRequired

Payment provider identifier: stripe, paypal, or nowpayments.

environmentstringRequired

Environment: sandbox or production.

labelstring

Optional label to identify this merchant account.

Provider-Specific Parameters

For Stripe:

stripe_secret_keystringRequired

Your Stripe secret key.

For PayPal:

paypal_client_idstringRequired

Your PayPal client ID.

paypal_client_secretstringRequired

Your PayPal client secret.

For NOWPayments:

nowpayments_api_keystringRequired

Your NOWPayments API key.

nowpayments_ipn_secretstringRequired

Your NOWPayments IPN secret.

Request
curl -X POST "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/merchant-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "stripe",
    "stripe_secret_key": "sk_live_...",
    "environment": "production"
  }'
Merchant account installedapplication/json
{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "POST",
  "path": "/v2/projects/YOUR_PROJECT_ID/merchant-accounts",
  "code": 201,
  "message": "Merchant account installed successfully",
  "data": {
    "merchant_account_id": "11111111-1111-1111-1111-111111111111",
    "provider": "stripe",
    "environment": "production",
    "active": true,
    "has_requirements": false,
    "configuration_editable": false,
    "label": null
  }
}

Last updated: