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 '{}'
{
  "merchant_id": "y3oqhf46pyzuxjbcn2giaqnb44",
  "profile_id": "pro_abcdefghijklmnopqrstuvwxyz",
  "profile_name": "<string>",
  "return_url": "https://www.example.com/success",
  "enable_payment_response_hash": true,
  "payment_response_hash_key": "<string>",
  "redirect_to_merchant_with_http_post": true,
  "webhook_details": {
    "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
  },
  "metadata": {},
  "routing_algorithm": {},
  "intent_fulfillment_time": 900,
  "frm_routing_algorithm": {},
  "payout_routing_algorithm": {
    "type": "single",
    "data": {
      "connector": "adyenplatform",
      "merchant_connector_id": "<string>"
    }
  },
  "applepay_verified_domains": [
    "<string>"
  ],
  "session_expiry": 900,
  "payment_link_config": "<any>",
  "authentication_connector_details": {
    "authentication_connectors": [
      "threedsecureio"
    ],
    "three_ds_requestor_url": "<string>"
  },
  "use_billing_as_payment_method_billing": true,
  "extended_card_info_config": {
    "public_key": "<string>",
    "ttl_in_secs": 3600
  },
  "collect_shipping_details_from_wallet_connector": true,
  "is_connector_agnostic_mit_enabled": true
}

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 business profile

return_url
string | null

The URL to redirect after the completion of the operation

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 default value is used.

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

You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long. Metadata is useful for storing additional, structured 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 expire client secret after certain amount of time to be supplied in seconds (900) for 15 mins

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 applepay domains for a particular profile

session_expiry
integer | null

Client Secret Default expiry for all payments created under this business profile

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

A boolean value to indicate if customer shipping details needs to be sent for wallets payments

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.

Response

200 - application/json
merchant_id
string
required

The identifier for Merchant Account

profile_id
string
required

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

profile_name
string
required

Name of the business profile

return_url
string | null

The URL to redirect after the completion of the operation

enable_payment_response_hash
boolean
default: truerequired

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 default value is used.

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

webhook_details
object
metadata
object | null

You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long. Metadata is useful for storing additional, structured 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 expire client secret after certain amount of time to be supplied in seconds (900) for 15 mins

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 applepay domains for a particular profile

session_expiry
integer | null

Client Secret Default expiry for all payments created under this business profile

payment_link_config
any | null

Default Payment Link config for all payment links created under this business profile

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

A boolean value to indicate if customer shipping details needs to be sent for wallets payments

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.