Create Merchant

This API is used to onboard a new merchant into the system. It initializes the merchant profile and enables the merchant to perform transactions.

Request

Header Params

Body Params application/json

Example

{
    "MerchantInfo": {
        "MerchantCode": "444000000000358",
        "CustomerNumber": 3958855994,
        "Chain": false,
        "ChainCode": "",
        "IsPf": false,
        "PfIdMsc": "",
        "PfIdVis": "",
        "BranchId": 444,
        "Mcc": "0763",
        "TradeName": "Effertz - Gerhold",
        "MerchantNameplate": "Gusikowski, Hagenes and Murazik",
        "TaxDepartmentCode": "4868",
        "TaxDepartment": "Jewelry",
        "TaxNumber": "25527987",
        "StatCode": "AA",
        "ClosedCase": "",
        "PosParamProfileGuid": 1,
        "PosParamProfileName": "DEFAULT - EUR",
        "CommissionProfileGuid": 1100000024665597,
        "CommissionProfileName": "[01] DEFAULT COMM PROFILE",
        "LoyaltyProfileGuid": "0",
        "LoyaltyProfileName": "",
        "PosFeeProfileGuid": 0,
        "PosFeeProfileName": "",
        "IsPg": false,
        "PgIdMsc": "",
        "PgIdVis": "",
        "FraudRate": 0
    },
    "MerchantAddressList": [
        {
            "AddressType": "01",
            "CountryCode": "TR",
            "StateCode": "34",
            "CityName": "DESERUNT",
            "AddressLine1": "UT EA TEMPOR",
            "AddressLine2": "TEMPOR UT AMET",
            "AddressLine3": "IPSUM SINT DESERUNT",
            "ZipCode": "34999"
        }
    ],
    "MerchantCommunicationList": [
        {
            "ComType": "07",
            "ComInfo": "867698487357",
            "ComInfoExt": ""
        }
    ],
    "MerchantContactList": [
        {
            "Title": "01",
            "Name": "MAGNA",
            "MidName": "COMMODO",
            "LastName": "VOLUPTATE",
            "PhoneNumber": "969986678926",
            "PhoneNumberExt": "",
            "Email": "eiusmod.cillum@occaecat.com"
        }
    ],
    "MerchantAccountList": [
        {
            "CurrencyCode": 978,
            "CurrentAccountBranchCode": 444,
            "CurrentAccountNumber": "977315323556",
            "CurrentAccountSuffix": 0
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://hilarion.corpayss.net:8422/api/IntegrationAcquirer/CreateMerchant' \
--header 'token: 58ff081d-eba7-4e9c-bfab-3cd51792b96d+202501211205' \
--header 'Content-Type: application/json' \
--data-raw '{
    "MerchantInfo": {
        "MerchantCode": "444000000000358",
        "CustomerNumber": 3958855994,
        "Chain": false,
        "ChainCode": "",
        "IsPf": false,
        "PfIdMsc": "",
        "PfIdVis": "",
        "BranchId": 444,
        "Mcc": "0763",
        "TradeName": "Effertz - Gerhold",
        "MerchantNameplate": "Gusikowski, Hagenes and Murazik",
        "TaxDepartmentCode": "4868",
        "TaxDepartment": "Jewelry",
        "TaxNumber": "25527987",
        "StatCode": "AA",
        "ClosedCase": "",
        "PosParamProfileGuid": 1,
        "PosParamProfileName": "DEFAULT - EUR",
        "CommissionProfileGuid": 1100000024665597,
        "CommissionProfileName": "[01] DEFAULT COMM PROFILE",
        "LoyaltyProfileGuid": "0",
        "LoyaltyProfileName": "",
        "PosFeeProfileGuid": 0,
        "PosFeeProfileName": "",
        "IsPg": false,
        "PgIdMsc": "",
        "PgIdVis": "",
        "FraudRate": 0
    },
    "MerchantAddressList": [
        {
            "AddressType": "01",
            "CountryCode": "TR",
            "StateCode": "34",
            "CityName": "DESERUNT",
            "AddressLine1": "UT EA TEMPOR",
            "AddressLine2": "TEMPOR UT AMET",
            "AddressLine3": "IPSUM SINT DESERUNT",
            "ZipCode": "34999"
        }
    ],
    "MerchantCommunicationList": [
        {
            "ComType": "07",
            "ComInfo": "867698487357",
            "ComInfoExt": ""
        }
    ],
    "MerchantContactList": [
        {
            "Title": "01",
            "Name": "MAGNA",
            "MidName": "COMMODO",
            "LastName": "VOLUPTATE",
            "PhoneNumber": "969986678926",
            "PhoneNumberExt": "",
            "Email": "eiusmod.cillum@occaecat.com"
        }
    ],
    "MerchantAccountList": [
        {
            "CurrencyCode": 978,
            "CurrentAccountBranchCode": 444,
            "CurrentAccountNumber": "977315323556",
            "CurrentAccountSuffix": 0
        }
    ]
}'

application/json

Body

Example

{
    "ResultObject": "4523271248",
    "Result": 0,
    "ReturnDescription": "Successfully completed.",
    "ApprovalRefNumber": 0
}

Request

Request Code Samples

Responses