1. Acquirer
Corpayss
  • API Changelog
  • Acquirer
    • Merchant
      • Create Merchant
      • Get Merchant
      • Update Merchant
      • Search Merchant
    • 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. Acquirer

Create Merchant and Terminal

POST
/api/Acquirer/CreateMerchantAndTerminal
This service is the basic version of merchant and terminal creation service. Backend sets default values if it is not sent by client.

Request

Header Params

Body Params application/json

Example
{
    "Terminal": {
        "TerminalType": "VP",
        "StatCode": "AA",
        "CloseDate": "0001-01-01T00:00:00",
        "SlipType": "03",
        "SlipName": "ALIQUA CONSEQUAT IN",
        "BatchNo": 0,
        "PosComProfileXid": 0,
        "AuthProfileXid": 2,
        "BatchCloseProfileXid": 0,
        "OptEnablePinBypass": true,
        "OptPinForBatchClose": true,
        "OptCardMenu": true,
        "OptBankLogo": true,
        "OptFallback": true,
        "OptManual": true,
        "OptMotoCvv2Onus": true,
        "OptMotoCvv2Int": true,
        "OptMotoCvv2Dom": true,
        "OptMotoCvv2Other": true,
        "OptMultiCurr": false,
        "AutoBatchCloseTime": 0,
        "OptSingleTapCap": true,
        "CountryCode": "TR",
        "StateCode": "34",
        "CityName": "SED",
        "AddressLine1": "NOSTRUD QUIS DO",
        "AddressLine2": "NOSTRUD SUNT CONSEQUAT",
        "AddressLine3": "PROIDENT AUTE FUGIAT",
        "ZipCode": "34999"
    },
    "Merchant": {
        "CustomerNumber": 1,
        "Chain": false,
        "ChainCode": "",
        "IsPf": false,
        "BranchId": 444,
        "Mcc": "0763",
        "TradeName": "IN AMET ET",
        "MerchantName": "OCCAECAT ALIQUIP IN",
        "TaxDepartmentCode": "0",
        "TaxDepartment": "",
        "TaxNumber": "0",
        "StatCode": "AA",
        "PosParamProfileXid": 1,
        "CommissionProfileXid": 1100000024665593,
        "LoyaltyProfileXid": 0,
        "PosFeeProfileXid": 0,
        "IsPg": false
    },
    "MerchantAddressList": [
        {
            "AddressType": "01",
            "CountryCode": "TR",
            "StateCode": "34",
            "CityName": "NON",
            "AddressLine1": "ULLAMCO ALIQUIP OCCAECAT",
            "AddressLine2": "DESERUNT DOLOR NISI",
            "AddressLine3": "ANIM LABORE IN",
            "ZipCode": "34999"
        }
    ],
    "MerchantCommunicationList": [
        {
            "ComType": "01",
            "ComInfo": "241678792672",
            "ComInfoExt": ""
        },
        {
            "ComType": "05",
            "ComInfo": "minim.qui@consequat.com",
            "ComInfoExt": ""
        },
        {
            "ComType": "07",
            "ComInfo": "126963756843",
            "ComInfoExt": ""
        },
        {
            "ComType": "08",
            "ComInfo": "http://www.non.non.com/",
            "ComInfoExt": ""
        }
    ],
    "MerchantContactList": [
        {
            "Title": "01",
            "Name": "SINT",
            "MidName": "UT",
            "LastName": "DOLOR",
            "PhoneNumber": "854755584368",
            "PhoneNumberExt": "",
            "Email": "in.labore@elit.com"
        }
    ],
    "MerchantAccountList": [
        {
            "Currency": 978,
            "CurrentAccountBranch": 444,
            "CurrentAccountNo": "849343354857",
            "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/CreateMerchantAndTerminal' \
--header 'token: 58ff081d-eba7-4e9c-bfab-3cd51792b96d+202501211205' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Terminal": {
        "TerminalType": "VP",
        "StatCode": "AA",
        "CloseDate": "0001-01-01T00:00:00",
        "SlipType": "03",
        "SlipName": "ALIQUA CONSEQUAT IN",
        "BatchNo": 0,
        "PosComProfileXid": 0,
        "AuthProfileXid": 2,
        "BatchCloseProfileXid": 0,
        "OptEnablePinBypass": true,
        "OptPinForBatchClose": true,
        "OptCardMenu": true,
        "OptBankLogo": true,
        "OptFallback": true,
        "OptManual": true,
        "OptMotoCvv2Onus": true,
        "OptMotoCvv2Int": true,
        "OptMotoCvv2Dom": true,
        "OptMotoCvv2Other": true,
        "OptMultiCurr": false,
        "AutoBatchCloseTime": 0,
        "OptSingleTapCap": true,
        "CountryCode": "TR",
        "StateCode": "34",
        "CityName": "SED",
        "AddressLine1": "NOSTRUD QUIS DO",
        "AddressLine2": "NOSTRUD SUNT CONSEQUAT",
        "AddressLine3": "PROIDENT AUTE FUGIAT",
        "ZipCode": "34999"
    },
    "Merchant": {
        "CustomerNumber": 1,
        "Chain": false,
        "ChainCode": "",
        "IsPf": false,
        "BranchId": 444,
        "Mcc": "0763",
        "TradeName": "IN AMET ET",
        "MerchantName": "OCCAECAT ALIQUIP IN",
        "TaxDepartmentCode": "0",
        "TaxDepartment": "",
        "TaxNumber": "0",
        "StatCode": "AA",
        "PosParamProfileXid": 1,
        "CommissionProfileXid": 1100000024665593,
        "LoyaltyProfileXid": 0,
        "PosFeeProfileXid": 0,
        "IsPg": false
    },
    "MerchantAddressList": [
        {
            "AddressType": "01",
            "CountryCode": "TR",
            "StateCode": "34",
            "CityName": "NON",
            "AddressLine1": "ULLAMCO ALIQUIP OCCAECAT",
            "AddressLine2": "DESERUNT DOLOR NISI",
            "AddressLine3": "ANIM LABORE IN",
            "ZipCode": "34999"
        }
    ],
    "MerchantCommunicationList": [
        {
            "ComType": "01",
            "ComInfo": "241678792672",
            "ComInfoExt": ""
        },
        {
            "ComType": "05",
            "ComInfo": "minim.qui@consequat.com",
            "ComInfoExt": ""
        },
        {
            "ComType": "07",
            "ComInfo": "126963756843",
            "ComInfoExt": ""
        },
        {
            "ComType": "08",
            "ComInfo": "http://www.non.non.com/",
            "ComInfoExt": ""
        }
    ],
    "MerchantContactList": [
        {
            "Title": "01",
            "Name": "SINT",
            "MidName": "UT",
            "LastName": "DOLOR",
            "PhoneNumber": "854755584368",
            "PhoneNumberExt": "",
            "Email": "in.labore@elit.com"
        }
    ],
    "MerchantAccountList": [
        {
            "Currency": 978,
            "CurrentAccountBranch": 444,
            "CurrentAccountNo": "849343354857",
            "CurrentAccountSuffix": 0
        }
    ]
}'

Responses

🟢200OK
application/json
OK
Bodyapplication/json

Example
{
    "ResultObject": {
        "MerchantCode": "100004440000839",
        "TerminalCode": "00100808"
    },
    "Result": 0,
    "ReturnDescription": "Successfully completed.",
    "ApprovalXid": 0
}
Modified at 2026-05-08 12:19:14
Previous
Delete Pos Fee Profile
Next
Get Merchant Payment Summary
Built with