1. Merchant
Corpayss
  • Acquirer
    • Merchant
      • Create Merchant
        POST
      • Get Merchant
        GET
      • Update Merchant
        POST
      • Search Merchant
        GET
    • Terminal
      • Create Terminal
      • Get Terminal
      • Update Terminal
      • Search Terminal
    • Deprecated - Commission Profile
      • Create Commission Profile
      • Get Commission Profile
      • Update Commission Profile
      • Delete Commission Profile
    • Pos Authorization Profile
      • Create Pos Authorization Profile
      • Get Pos Authorization Profile
      • Update Pos Authorization Profile
      • Delete Pos Authorization Profile
    • Pos Fee Profile
      • Create Pos Fee Profile
      • Get Pos Fee Profile
      • Update Pos Fee Profile
      • Delete Pos Fee Profile
    • Create Merchant and Terminal
      POST
    • Get Merchant Payment Summary
      GET
    • Get Merchant Payment Detail
      GET
    • Get Pos Batch Summary
      GET
    • Get Pos Batch Detail
      GET
    • Close Pos Batch
      POST
  • Issuer
    • Customer
      • Create Customer
      • Get Customer Info
      • Get Card Customer Info
      • Update Customer
      • Update Customer Limit
    • Card
      • Creation & Registration
        • Create Credit Card
        • Create Debit Card
        • Create Prepaid Card
        • Create Emboss Directive
        • Register Card
      • Information & Status Management
        • Get Card Info
        • Get Card Status
        • Get Host Balance
        • Update Card Limit
        • Update Card Status
        • Update Card Fee Status
      • Transactions & Balance Operations
        • Get Card Transactions
        • Send Transaction
        • Load Card Balance
        • Card To Card Balance Transfer
        • Money Send
      • Security & Authentication
        • Verify Card
        • Get Card Pin
        • Send PIN By SMS
        • Check Pin
        • Change Card Pin
        • Reset Cvv 2 Retry Count
        • Change 3DS Password
      • Maintenance & Restrictions
        • Get Card Restriction
        • Card Restriction
        • Card Renewal
      • Tokenization
        • Tokenize Card No
      • Deprecated
        • Get Card Balance Loading Limit
        • Get Card No
        • Get Card Private Info
  • VPOS
    • 3DS Transaction
      • ThreeD - Sale
      • ThreeD - Pre Sale
      • ThreeD - Complete 3DS Payment
    • NonSecure
      • Batch Close
      • Payment Sale
      • Installment Inquiry
      • Point Inquiry
      • Payment Pre Sale
      • Payment Post Sale
      • Payment Void
      • Payment Refund
    • QR Transaction
      • QR Payment CreateQr
    • Inquiry
      • Chek ByToken
      • Check By Order ID
      • Chek By Process ID
      • List By Order ID
    • Order
      • Create Order 3D
      • Create Order
    • Recurring
      • Create Recurring
      • Get Recurring
      • Update Recurring
      • Cancel Recurring
  1. Merchant

Create Merchant

POST
/api/IntegrationAcquirer/CreateMerchant
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": "646698094409845",
        "IsPf": true,
        "PfIdMsc": "ut",
        "PfIdVis": "sint aute occaecat in",
        "BranchId": 444,
        "Mcc": "0763",
        "TradeName": "Terry - Hamill",
        "MerchantNameplate": "Wuckert, Nikolaus and Kautzer",
        "TaxDepartmentCode": "4868",
        "TaxDepartment": "Beauty",
        "TaxNumber": "25527987",
        "StatCode": "AA",
        "ClosedCase": "sed anim labore amet id",
        "PosParamProfileGuid": 1,
        "PosParamProfileName": "DEFAULT - EUR",
        "CommissionProfileGuid": 1100000024665597,
        "CommissionProfileName": "[01] DEFAULT COMM PROFILE",
        "LoyaltyProfileGuid": 0,
        "LoyaltyProfileName": "deploy_clearly_rigidly.pps",
        "PosFeeProfileGuid": 0,
        "PosFeeProfileName": "giant_pause_aha.xsd",
        "IsPg": false,
        "PgIdMsc": "ex incididunt voluptate",
        "PgIdVis": "magna in elit deserunt occaecat",
        "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": "01",
            "ComInfo": "867698487357",
            "ComInfoExt": "incidid"
        },
        {
            "ComType": "07",
            "ComInfo": "http://www.ut.qui.com/",
            "ComInfoExt": "in "
        },
        {
            "ComType": "07",
            "ComInfo": "789377613919",
            "ComInfoExt": "occa"
        },
        {
            "ComType": "01",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "cil"
        },
        {
            "ComType": "01",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "et l"
        },
        {
            "ComType": "05",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "eu repre"
        },
        {
            "ComType": "08",
            "ComInfo": "http://www.ut.qui.com/",
            "ComInfoExt": "dolo"
        }
    ],
    "MerchantContactList": [
        {
            "Title": "01",
            "Name": "MAGNA",
            "MidName": "COMMODO",
            "LastName": "VOLUPTATE",
            "PhoneNumber": "969986678926",
            "PhoneNumberExt": "(410)",
            "Email": "eiusmod.cillum@occaecat.com"
        }
    ],
    "MerchantAccountList": [
        {
            "CurrencyCode": 978,
            "CurrentAccountBranchCode": 444,
            "CurrentAccountNumber": "977315323556",
            "CurrentAccountSuffix": 0
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://hilarion1.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": "646698094409845",
        "IsPf": true,
        "PfIdMsc": "ut",
        "PfIdVis": "sint aute occaecat in",
        "BranchId": 444,
        "Mcc": "0763",
        "TradeName": "Terry - Hamill",
        "MerchantNameplate": "Wuckert, Nikolaus and Kautzer",
        "TaxDepartmentCode": "4868",
        "TaxDepartment": "Beauty",
        "TaxNumber": "25527987",
        "StatCode": "AA",
        "ClosedCase": "sed anim labore amet id",
        "PosParamProfileGuid": 1,
        "PosParamProfileName": "DEFAULT - EUR",
        "CommissionProfileGuid": 1100000024665597,
        "CommissionProfileName": "[01] DEFAULT COMM PROFILE",
        "LoyaltyProfileGuid": 0,
        "LoyaltyProfileName": "deploy_clearly_rigidly.pps",
        "PosFeeProfileGuid": 0,
        "PosFeeProfileName": "giant_pause_aha.xsd",
        "IsPg": false,
        "PgIdMsc": "ex incididunt voluptate",
        "PgIdVis": "magna in elit deserunt occaecat",
        "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": "01",
            "ComInfo": "867698487357",
            "ComInfoExt": "incidid"
        },
        {
            "ComType": "07",
            "ComInfo": "http://www.ut.qui.com/",
            "ComInfoExt": "in "
        },
        {
            "ComType": "07",
            "ComInfo": "789377613919",
            "ComInfoExt": "occa"
        },
        {
            "ComType": "01",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "cil"
        },
        {
            "ComType": "01",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "et l"
        },
        {
            "ComType": "05",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "eu repre"
        },
        {
            "ComType": "08",
            "ComInfo": "http://www.ut.qui.com/",
            "ComInfoExt": "dolo"
        }
    ],
    "MerchantContactList": [
        {
            "Title": "01",
            "Name": "MAGNA",
            "MidName": "COMMODO",
            "LastName": "VOLUPTATE",
            "PhoneNumber": "969986678926",
            "PhoneNumberExt": "(410)",
            "Email": "eiusmod.cillum@occaecat.com"
        }
    ],
    "MerchantAccountList": [
        {
            "CurrencyCode": 978,
            "CurrentAccountBranchCode": 444,
            "CurrentAccountNumber": "977315323556",
            "CurrentAccountSuffix": 0
        }
    ]
}'

Responses

🟢200OK
application/json
OK
Body

Example
{
    "ResultObject": "4523271248",
    "Result": 0,
    "ReturnDescription": "Successfully completed.",
    "ApprovalRefNumber": 0
}
Modified at 2026-03-24 08:22:08
Previous
Acquirer
Next
Get Merchant
Built with