1. Merchant
Corpayss
  • API Changelog
  • Acquirer
    • Merchant
      • Create Merchant
        POST
      • Get Merchant
        POST
      • Update Merchant
        POST
      • Search Merchant
        POST
    • 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
      POST
    • Get Merchant Payment Detail
      POST
    • Get Pos Batch Summary
      POST
    • Get Pos Batch Detail
      POST
    • 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 Request
        • 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
        • Card To Card Balance Transfer
        • Money Send
        • Load Card Balance
      • 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
      • Deprecated
        • Tokenization
          • Tokenize Card No
        • Get Card Balance Loading Limit
        • Get Card No
        • Get Card Private Info
  • Online Payments
    • Card Payments
      • Non-3DS Payments
        • Create Non-3DS Payment
        • Create Non-3DS Pre-Authorization
        • Create Post Authorization
      • 3DS Payments
        • Create 3DS Payment
        • Create 3DS Pre-Authorization
        • Complete 3DS Payment
      • Refunds & Voids
        • Void Payment
        • Refund Payment
    • Payment Links
      • Create 3DS Payment Link
      • Create Non-3DS Payment Link
    • Payment Queries
      • Check Payment by Token
      • Check Payment by Order ID
      • Check Payment by Process ID
      • List Payments by Order ID
    • Recurring Payments
      • Pause Recurring
      • Resume Recurring
      • Reset Plan To Pending
      • Create Recurring
      • Get Recurring
      • Update Recurring
      • Cancel Recurring
    • Batch
      • Batch Close
    • DEPRECATED
      • QR Transaction
        • QR Payment CreateQr
      • Installment Inquiry
      • Point Inquiry
  1. Merchant

Create Merchant

POST
/api/Acquirer/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
{
    "Merchant": {
        "MerchantCode": "444000000000358",
        "CustomerNumber": 3958855994,
        "Chain": false,
        "ChainCode": "",
        "IsPf": true,
        "PfIdMsc": "reprehenderit elit voluptate",
        "PfIdVis": "eiusmod",
        "BranchId": 444,
        "Mcc": "0763",
        "TradeName": "Witting - Wisozk",
        "MerchantName": "VonRueden - Romaguera",
        "TaxDepartmentCode": "4868",
        "TaxDepartment": "Grocery",
        "TaxNumber": "25527987",
        "StatCode": "AA",
        "ClosedCase": "05",
        "PosParamProfileXid": 1,
        "PosParamProfileName": "DEFAULT - EUR",
        "CommissionProfileXid": 1100000024665597,
        "CommissionProfileName": "[01] DEFAULT COMM PROFILE",
        "LoyaltyProfileXid": 0,
        "LoyaltyProfileName": "furthermore.doc",
        "PosFeeProfileXid": 0,
        "PosFeeProfileName": "duh_frantically.mpe",
        "IsPg": true,
        "PgIdMsc": "culpa in deserunt dolor",
        "PgIdVis": "Duis consequat dolore ut"
    },
    "MerchantAddressList": [
        {
            "AddressType": "01",
            "CountryCode": "MT",
            "StateCode": "13",
            "CityName": "DESERUNT",
            "AddressLine1": "UT EA TEMPOR",
            "AddressLine2": "TEMPOR UT AMET",
            "AddressLine3": "IPSUM SINT DESERUNT",
            "ZipCode": "34999"
        }
    ],
    "MerchantCommunicationList": [
        {
            "ComType": "07",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "01",
            "ComInfo": "http://www.ut.qui.com/",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "05",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "07",
            "ComInfo": "789377613919",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "01",
            "ComInfo": "789377613919",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "05",
            "ComInfo": "789377613919",
            "ComInfoExt": "mollit "
        }
    ],
    "MerchantContactList": [
        {
            "Title": "01",
            "Name": "MAGNA",
            "MidName": "COMMODO",
            "LastName": "VOLUPTATE",
            "PhoneNumber": "969986678926",
            "PhoneNumberExt": "(599)",
            "Email": "eiusmod.cillum@occaecat.com"
        }
    ],
    "MerchantAccountList": [
        {
            "Currency": 978,
            "CurrentAccountBranch": 444,
            "CurrentAccountNo": "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 'https://hilarionapi.corpayss.net//api/Acquirer/CreateMerchant' \
--header 'token: 58ff081d-eba7-4e9c-bfab-3cd51792b96d+202501211205' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Merchant": {
        "MerchantCode": "444000000000358",
        "CustomerNumber": 3958855994,
        "Chain": false,
        "ChainCode": "",
        "IsPf": true,
        "PfIdMsc": "reprehenderit elit voluptate",
        "PfIdVis": "eiusmod",
        "BranchId": 444,
        "Mcc": "0763",
        "TradeName": "Witting - Wisozk",
        "MerchantName": "VonRueden - Romaguera",
        "TaxDepartmentCode": "4868",
        "TaxDepartment": "Grocery",
        "TaxNumber": "25527987",
        "StatCode": "AA",
        "ClosedCase": "05",
        "PosParamProfileXid": 1,
        "PosParamProfileName": "DEFAULT - EUR",
        "CommissionProfileXid": 1100000024665597,
        "CommissionProfileName": "[01] DEFAULT COMM PROFILE",
        "LoyaltyProfileXid": 0,
        "LoyaltyProfileName": "furthermore.doc",
        "PosFeeProfileXid": 0,
        "PosFeeProfileName": "duh_frantically.mpe",
        "IsPg": true,
        "PgIdMsc": "culpa in deserunt dolor",
        "PgIdVis": "Duis consequat dolore ut"
    },
    "MerchantAddressList": [
        {
            "AddressType": "01",
            "CountryCode": "MT",
            "StateCode": "13",
            "CityName": "DESERUNT",
            "AddressLine1": "UT EA TEMPOR",
            "AddressLine2": "TEMPOR UT AMET",
            "AddressLine3": "IPSUM SINT DESERUNT",
            "ZipCode": "34999"
        }
    ],
    "MerchantCommunicationList": [
        {
            "ComType": "07",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "01",
            "ComInfo": "http://www.ut.qui.com/",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "05",
            "ComInfo": "cillum.magna@ea.com",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "07",
            "ComInfo": "789377613919",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "01",
            "ComInfo": "789377613919",
            "ComInfoExt": "mollit "
        },
        {
            "ComType": "05",
            "ComInfo": "789377613919",
            "ComInfoExt": "mollit "
        }
    ],
    "MerchantContactList": [
        {
            "Title": "01",
            "Name": "MAGNA",
            "MidName": "COMMODO",
            "LastName": "VOLUPTATE",
            "PhoneNumber": "969986678926",
            "PhoneNumberExt": "(599)",
            "Email": "eiusmod.cillum@occaecat.com"
        }
    ],
    "MerchantAccountList": [
        {
            "Currency": 978,
            "CurrentAccountBranch": 444,
            "CurrentAccountNo": "977315323556",
            "CurrentAccountSuffix": 0
        }
    ]
}'

Responses

🟢200OK
application/json
OK
Bodyapplication/json

Example
{
    "ResultObject": "4523271248",
    "Result": 0,
    "ReturnDescription": "Successfully completed.",
    "ApprovalXid": 0
}
Modified at 2026-06-15 08:30:46
Previous
Acquirer
Next
Get Merchant
Built with