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

Authorizations

api-key
string
headerrequired

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

Path Parameters

account_id
string
required

The unique identifier for the merchant account

Body

application/json
merchant_id
string
required

The identifier for the Merchant Account

merchant_name
string | null

Name of the Merchant Account

merchant_details
object
return_url
string | null

The URL to redirect after the completion of the operation

webhook_details
object
payout_routing_algorithm
object

Routing Algorithm kind

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.

parent_merchant_id
string | null

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

enable_payment_response_hash
boolean | null
default: false

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

payment_response_hash_key
string | null

Refers to the hash key used for calculating the signature for webhooks and redirect response.

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

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 server side API access

locker_id
string | null

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

primary_business_details
object[] | null

Details about the primary business unit of the merchant account

frm_routing_algorithm
object | null

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

default_profile
string | null

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

pm_collect_link_config
object

Object for GenericLinkUiConfig

Response

200 - application/json
merchant_id
string
required

The identifier for the Merchant Account

merchant_name
string | null

Name of the Merchant Account

return_url
string | null

The URL to redirect after completion of the payment

enable_payment_response_hash
boolean
default: falserequired

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

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
default: falserequired

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

merchant_details
object
webhook_details
object
payout_routing_algorithm
object

Routing Algorithm kind

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.

parent_merchant_id
string | null

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

publishable_key
string | null

API key that will be used for server side API access

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.

primary_business_details
object[]
required

Details about the primary business unit of the merchant account

frm_routing_algorithm
object

Routing Algorithm kind

organization_id
string
required

The organization id merchant is associated with

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

default_profile
string | null

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

recon_status
enum<string>
required
Available options:
not_requested,
requested,
active,
disabled
pm_collect_link_config
object

Object for GenericLinkUiConfig