Merchant Account - Create

curl --request POST \
  --url https://sandbox.birrpay.io/accounts \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "merchant_id": "merchant_abc"
}
'

{
  "merchant_id": "y3oqhf46pyzuxjbcn2giaqnb44",
  "enable_payment_response_hash": true,
  "redirect_to_merchant_with_http_post": true,
  "primary_business_details": [
    {
      "country": "AF",
      "business": "food"
    }
  ],
  "organization_id": "org_q98uSGAYbjEwqs0mJwnz",
  "is_recon_enabled": true,
  "recon_status": "not_requested",
  "merchant_account_type": "standard",
  "merchant_name": "NewAge Retailer",
  "return_url": "https://www.example.com/success",
  "payment_response_hash_key": "xkkdf909012sdjki2dkh5sdf",
  "merchant_details": {
    "primary_contact_person": "John Doe",
    "primary_phone": "999999999",
    "primary_email": "[email protected]",
    "secondary_contact_person": "John Doe2",
    "secondary_phone": "999999988",
    "secondary_email": "[email protected]",
    "website": "www.example.com",
    "about_business": "Online Retail with a wide selection of organic products for North America",
    "address": {
      "city": "New York",
      "country": "AF",
      "line1": "123, King Street",
      "line2": "Powelson Avenue",
      "line3": "Bridgewater",
      "zip": "08807",
      "state": "New York",
      "first_name": "John",
      "last_name": "Doe",
      "origin_zip": "08807"
    },
    "merchant_tax_registration_id": "123456789"
  },
  "webhook_details": {
    "payment_statuses_enabled": [
      "succeeded",
      "failed",
      "partially_captured",
      "requires_merchant_action"
    ],
    "refund_statuses_enabled": [
      "success",
      "failure"
    ],
    "webhook_version": "1.0.2",
    "webhook_username": "ekart_retail",
    "webhook_password": "ekart@123",
    "webhook_url": "www.ekart.com/webhooks",
    "payment_created_enabled": true,
    "payment_succeeded_enabled": true,
    "payment_failed_enabled": true,
    "payout_statuses_enabled": [
      "success",
      "failed"
    ]
  },
  "payout_routing_algorithm": {
    "type": "single",
    "data": {
      "connector": "authipay",
      "merchant_connector_id": "<string>"
    }
  },
  "sub_merchants_enabled": false,
  "parent_merchant_id": "xkkdf909012sdjki2dkh5sdf",
  "publishable_key": "AH3423bkjbkjdsfbkj",
  "metadata": {},
  "locker_id": "locker_abc123",
  "frm_routing_algorithm": {
    "type": "single",
    "data": {
      "connector": "authipay",
      "merchant_connector_id": "<string>"
    }
  },
  "default_profile": "<string>",
  "pm_collect_link_config": {
    "allowed_domains": [
      "<string>"
    ],
    "enabled_payment_methods": "[{\"payment_method\": \"bank_transfer\", \"payment_method_types\": [\"ach\", \"bacs\", \"sepa\"]}]",
    "logo": "https://birrpay.io/favicon.ico",
    "merchant_name": "BirrPay",
    "theme": "#4285F4",
    "domain_name": "<string>"
  },
  "product_type": "orchestration"
}

POST

accounts

curl --request POST \
  --url https://sandbox.birrpay.io/accounts \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "merchant_id": "merchant_abc"
}
'

{
  "merchant_id": "y3oqhf46pyzuxjbcn2giaqnb44",
  "enable_payment_response_hash": true,
  "redirect_to_merchant_with_http_post": true,
  "primary_business_details": [
    {
      "country": "AF",
      "business": "food"
    }
  ],
  "organization_id": "org_q98uSGAYbjEwqs0mJwnz",
  "is_recon_enabled": true,
  "recon_status": "not_requested",
  "merchant_account_type": "standard",
  "merchant_name": "NewAge Retailer",
  "return_url": "https://www.example.com/success",
  "payment_response_hash_key": "xkkdf909012sdjki2dkh5sdf",
  "merchant_details": {
    "primary_contact_person": "John Doe",
    "primary_phone": "999999999",
    "primary_email": "[email protected]",
    "secondary_contact_person": "John Doe2",
    "secondary_phone": "999999988",
    "secondary_email": "[email protected]",
    "website": "www.example.com",
    "about_business": "Online Retail with a wide selection of organic products for North America",
    "address": {
      "city": "New York",
      "country": "AF",
      "line1": "123, King Street",
      "line2": "Powelson Avenue",
      "line3": "Bridgewater",
      "zip": "08807",
      "state": "New York",
      "first_name": "John",
      "last_name": "Doe",
      "origin_zip": "08807"
    },
    "merchant_tax_registration_id": "123456789"
  },
  "webhook_details": {
    "payment_statuses_enabled": [
      "succeeded",
      "failed",
      "partially_captured",
      "requires_merchant_action"
    ],
    "refund_statuses_enabled": [
      "success",
      "failure"
    ],
    "webhook_version": "1.0.2",
    "webhook_username": "ekart_retail",
    "webhook_password": "ekart@123",
    "webhook_url": "www.ekart.com/webhooks",
    "payment_created_enabled": true,
    "payment_succeeded_enabled": true,
    "payment_failed_enabled": true,
    "payout_statuses_enabled": [
      "success",
      "failed"
    ]
  },
  "payout_routing_algorithm": {
    "type": "single",
    "data": {
      "connector": "authipay",
      "merchant_connector_id": "<string>"
    }
  },
  "sub_merchants_enabled": false,
  "parent_merchant_id": "xkkdf909012sdjki2dkh5sdf",
  "publishable_key": "AH3423bkjbkjdsfbkj",
  "metadata": {},
  "locker_id": "locker_abc123",
  "frm_routing_algorithm": {
    "type": "single",
    "data": {
      "connector": "authipay",
      "merchant_connector_id": "<string>"
    }
  },
  "default_profile": "<string>",
  "pm_collect_link_config": {
    "allowed_domains": [
      "<string>"
    ],
    "enabled_payment_methods": "[{\"payment_method\": \"bank_transfer\", \"payment_method_types\": [\"ach\", \"bacs\", \"sepa\"]}]",
    "logo": "https://birrpay.io/favicon.ico",
    "merchant_name": "BirrPay",
    "theme": "#4285F4",
    "domain_name": "<string>"
  },
  "product_type": "orchestration"
}

Authorizations

api-key

string

header

required

Admin API keys allow you to perform some privileged actions such as creating a merchant account and Merchant Connector account.

Body

application/json

merchant_id

string

required

The identifier for the Merchant Account

Required string length: 1 - 64

Example:

"y3oqhf46pyzuxjbcn2giaqnb44"

merchant_name

string | null

Name of the Merchant Account

Example:

"NewAge Retailer"

merchant_details

object | null

Show child attributes

return_url

string | null

The URL to redirect after the completion of the operation

Maximum string length: 255

Example:

"https://www.example.com/success"

webhook_details

object | null

Show child attributes

payout_routing_algorithm

object

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

sub_merchants_enabled

boolean | null

default:false

A boolean value to indicate if the merchant is a sub-merchant under a master or a parent merchant. By default, its value is false.

Example:

false

parent_merchant_id

string | null

Refers to the Parent Merchant ID if the merchant being created is a sub-merchant

Maximum string length: 255

Example:

"xkkdf909012sdjki2dkh5sdf"

enable_payment_response_hash

boolean | null

default:false

A boolean value to indicate if payment response hash needs to be enabled

Example:

true

payment_response_hash_key

string | null

Refers to the hash key used for calculating the signature for webhooks and redirect response. If the value is not provided, a value is automatically generated.

redirect_to_merchant_with_http_post

boolean | null

default:false

A boolean value to indicate if redirect to merchant with http post needs to be enabled.

Example:

true

metadata

object | null

Metadata is useful for storing additional, unstructured information on an object

publishable_key

string | null

API key that will be used for client side API access. A publishable key has to be always paired with a client_secret. A client_secret can be obtained by creating a payment with confirm set to false

Example:

"AH3423bkjbkjdsfbkj"

locker_id

string | null

An identifier for the vault used to store payment method information.

Example:

"locker_abc123"

primary_business_details

object | null

Show child attributes

frm_routing_algorithm

object | null

The frm routing algorithm to be used for routing payments to desired FRM's

organization_id

string | null

The id of the organization to which the merchant belongs to, if not passed an organization is created

Required string length: 1 - 64

Example:

"org_q98uSGAYbjEwqs0mJwnz"

pm_collect_link_config

object | null

Object for GenericLinkUiConfig

Show child attributes

product_type

enum<string> | null

Available options:

orchestration,

vault,

recon,

recovery,

cost_observability,

dynamic_routing

merchant_account_type

enum<string> | null

Available options:

standard,

platform,

connected

Response

Merchant Account Created

merchant_id

string

required

The identifier for the Merchant Account

Maximum string length: 64

Example:

"y3oqhf46pyzuxjbcn2giaqnb44"

enable_payment_response_hash

boolean

default:false

required

A boolean value to indicate if payment response hash needs to be enabled

Example:

true

redirect_to_merchant_with_http_post

boolean

default:false

required

A boolean value to indicate if redirect to merchant with http post needs to be enabled

Example:

true

primary_business_details

object[]

required

Details about the primary business unit of the merchant account

Show child attributes

organization_id

string

required

The organization id merchant is associated with

Required string length: 1 - 64

Example:

"org_q98uSGAYbjEwqs0mJwnz"

is_recon_enabled

boolean

required

A boolean value to indicate if the merchant has recon service is enabled or not, by default value is false

recon_status

enum<string>

required

Available options:

not_requested,

requested,

active,

disabled

merchant_account_type

enum<string>

required

Available options:

standard,

platform,

connected

merchant_name

string | null

Name of the Merchant Account

Example:

"NewAge Retailer"

return_url

string | null

The URL to redirect after completion of the payment

Maximum string length: 255

Example:

"https://www.example.com/success"

payment_response_hash_key

string | null

Refers to the hash key used for calculating the signature for webhooks and redirect response. If the value is not provided, a value is automatically generated.

Maximum string length: 255

Example:

"xkkdf909012sdjki2dkh5sdf"

merchant_details

object | null

Show child attributes

webhook_details

object | null

Show child attributes

payout_routing_algorithm

object

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

sub_merchants_enabled

boolean | null

default:false

A boolean value to indicate if the merchant is a sub-merchant under a master or a parent merchant. By default, its value is false.

Example:

false

parent_merchant_id

string | null

Refers to the Parent Merchant ID if the merchant being created is a sub-merchant

Maximum string length: 255

Example:

"xkkdf909012sdjki2dkh5sdf"

publishable_key

string | null

API key that will be used for server side API access

Example:

"AH3423bkjbkjdsfbkj"

metadata

object | null

Metadata is useful for storing additional, unstructured information on an object.

locker_id

string | null

An identifier for the vault used to store payment method information.

Example:

"locker_abc123"

frm_routing_algorithm

object

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

default_profile

string | null

The default profile that must be used for creating merchant accounts and payments

Maximum string length: 64

pm_collect_link_config

object | null

Object for GenericLinkUiConfig

Show child attributes

product_type

enum<string> | null

Available options:

orchestration,

vault,

recon,

recovery,

cost_observability,

dynamic_routing

Get Started

Essentials

Payments Core APIs

Account management APIs

Other APIs

Merchant Account - Create

Authorizations

Body

Response