POST
/
account
/
{account_id}
/
business_profile
curl --request POST \
  --url https://sandbox.hyperswitch.io/account/{account_id}/business_profile \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{}'

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
profile_name
string | null

The name of profile

Maximum length: 64
return_url
string | null

The URL to redirect after the completion of the operation

Maximum length: 255
enable_payment_response_hash
boolean | null
default: true

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 | null
default: false

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

webhook_details
object
metadata
object | null

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

routing_algorithm
object | null

The routing algorithm to be used for routing payments to desired connectors

intent_fulfillment_time
integer | null

Will be used to determine the time till which your payment will be active once the payment session starts

Required range: x > 0
frm_routing_algorithm
object | null

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

payout_routing_algorithm
object

Routing Algorithm kind

applepay_verified_domains
string[] | null

Verified Apple Pay domains for a particular profile

session_expiry
integer | null

Client Secret Default expiry for all payments created under this profile

Required range: x > 0
payment_link_config
object
authentication_connector_details
object
use_billing_as_payment_method_billing
boolean | null

Whether to use the billing details passed when creating the intent as payment method billing

collect_shipping_details_from_wallet_connector
boolean | null
default: false

A boolean value to indicate if customer shipping details needs to be collected from wallet connector only if it is required field for connector (Eg. Apple Pay, Google Pay etc)

collect_billing_details_from_wallet_connector
boolean | null
default: false

A boolean value to indicate if customer billing details needs to be collected from wallet connector only if it is required field for connector (Eg. Apple Pay, Google Pay etc)

always_collect_shipping_details_from_wallet_connector
boolean | null
default: false

A boolean value to indicate if customer shipping details needs to be collected from wallet connector irrespective of connector required fields (Eg. Apple pay, Google pay etc)

always_collect_billing_details_from_wallet_connector
boolean | null
default: false

A boolean value to indicate if customer billing details needs to be collected from wallet connector irrespective of connector required fields (Eg. Apple pay, Google pay etc)

is_connector_agnostic_mit_enabled
boolean | null

Indicates if the MIT (merchant initiated transaction) payments can be made connector agnostic, i.e., MITs may be processed through different connector than CIT (customer initiated transaction) based on the routing rules. If set to false, MIT will go through the same connector as the CIT.

payout_link_config
object

Object for GenericLinkUiConfig

outgoing_webhook_custom_http_headers
object | null

These key-value pairs are sent as additional custom headers in the outgoing webhook request. It is recommended not to use more than four key-value pairs.

tax_connector_id
string | null

Merchant Connector id to be stored for tax_calculator connector

is_tax_connector_enabled
boolean

Indicates if tax_calculator connector is enabled or not. If set to true tax_connector_id will be checked.

is_network_tokenization_enabled
boolean

Indicates if network tokenization is enabled or not.

is_auto_retries_enabled
boolean | null

Indicates if is_auto_retries_enabled is enabled or not.

max_auto_retries_enabled
integer | null

Maximum number of auto retries allowed for a payment

Required range: x > 0

Response

200 - application/json
merchant_id
string
required

The identifier for Merchant Account

Maximum length: 64
profile_id
string
required

The identifier for profile. This must be used for creating merchant accounts, payments and payouts

Maximum length: 64
profile_name
string
required

Name of the profile

Maximum length: 64
enable_payment_response_hash
boolean
default: truerequired

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

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

is_tax_connector_enabled
boolean
required

Indicates if tax_calculator connector is enabled or not. If set to true tax_connector_id will be checked.

is_network_tokenization_enabled
boolean
default: falserequired

Indicates if network tokenization is enabled or not.

is_auto_retries_enabled
boolean
default: falserequired

Indicates if is_auto_retries_enabled is enabled or not.

return_url
string | null

The URL to redirect after the completion of the operation

Maximum length: 255
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.

webhook_details
object
metadata
object | null

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

routing_algorithm
object | null

The routing algorithm to be used for routing payments to desired connectors

intent_fulfillment_time
integer | null

Will be used to determine the time till which your payment will be active once the payment session starts

frm_routing_algorithm
object | null

The routing algorithm to be used to process the incoming request from merchant to outgoing payment processor or payment method. The default is 'Custom'

payout_routing_algorithm
object

Routing Algorithm kind

applepay_verified_domains
string[] | null

Verified Apple Pay domains for a particular profile

session_expiry
integer | null

Client Secret Default expiry for all payments created under this profile

payment_link_config
object
authentication_connector_details
object
use_billing_as_payment_method_billing
boolean | null
extended_card_info_config
object
collect_shipping_details_from_wallet_connector
boolean | null
default: false

A boolean value to indicate if customer shipping details needs to be collected from wallet connector only if it is required field for connector (Eg. Apple Pay, Google Pay etc)

collect_billing_details_from_wallet_connector
boolean | null
default: false

A boolean value to indicate if customer billing details needs to be collected from wallet connector only if it is required field for connector (Eg. Apple Pay, Google Pay etc)

always_collect_shipping_details_from_wallet_connector
boolean | null
default: false

A boolean value to indicate if customer shipping details needs to be collected from wallet connector irrespective of connector required fields (Eg. Apple pay, Google pay etc)

always_collect_billing_details_from_wallet_connector
boolean | null
default: false

A boolean value to indicate if customer billing details needs to be collected from wallet connector irrespective of connector required fields (Eg. Apple pay, Google pay etc)

is_connector_agnostic_mit_enabled
boolean | null

Indicates if the MIT (merchant initiated transaction) payments can be made connector agnostic, i.e., MITs may be processed through different connector than CIT (customer initiated transaction) based on the routing rules. If set to false, MIT will go through the same connector as the CIT.

payout_link_config
object

Object for GenericLinkUiConfig

outgoing_webhook_custom_http_headers
object | null

These key-value pairs are sent as additional custom headers in the outgoing webhook request.

tax_connector_id
string | null

Merchant Connector id to be stored for tax_calculator connector

max_auto_retries_enabled
integer | null

Maximum number of auto retries allowed for a payment

Merchant Account - KV StatusProfile - Update