Payment Gateway

Create Merchant ID

Create Merchant ID is an optional service that allows merchants to generate their own merchant code (commcode).

Flow

You send the required parameters to make a request, and Espay Payment Gateway will respond in JSON format.

HTTP Headers

Key Value
Method
HTTP Post
Connection
keep-alive
Content-Length
250
Content-Type
application/json
Accept
*/*

API URL

Environment URL
Sandbox
Port of HTTPS (443)
https://sandbox-api.espay.id/rest/merchanttools/registercommunity
Production
Port of HTTPS (443)
https://api-merchant.espay.id/rest/merchanttools/registercommunity

Request Parameters

Parameter Type Mandatory Description
rq_uuid
String (64)
Y
Request identifier. A unique ID used to identify messages.
rq_datetime
String (19)
Y
Date and time of the transaction request from the merchant's server.

Format:
yyyy-MM-ddThh:mi:ssTZD (ISO 8601)

Example:
2025-01-20T08:41:41+07:00
sender_id
String (32)
Y
Sender code provided by the Espay team and defined as a fixed value.
data
JSON Object
  merchantId
String (20)
Y
Merchant code sent from the merchant side.

Example:
TOKOKUSHOPPING
  merchantName
String (64)
Y
Merchant name sent from the merchant side.
  publicKeyIqos
RSA 2048
O
IQOS public key.
  productChannels
Array
Y
Bank channel to be used.
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Type Mandatory Description
responseCode
String (7)
Y
Response code.
responseMessage
String (150)
Y
Response description.
data
Object
Y
  apiKey
String (32)
Y
API key generated by Espay.
  merchantCode
String(20)
Y
Merchant code (comm code) used to call the Espay API.

Example:
SGWTOKOKUSHOPPING
  merchantName
String (64)
Y
Merchant name registered with Espay.
  password
String (16)
Y
API password used to call the Espay API.
  signatureKey
String (16)
Y
API signature used to call the Espay API.
  productChannels
Array
Y
Bank channels enabled by Espay.
  paymentUrl
String (255)
Y
Registered merchant payment URL.
  publicKeyEspay
RSA 2048
Y
Espay public key that can be used by the merchant for validation.
  inquiryUrl
String (255)
Y
Registered merchant Inquiry URL.
  settlementUrl
String (255)
Y
Registered merchant Settlement URL
Y: Yes, O: Optional, C: Conditional





































Sample Request

POST /rest/merchanttools/registercommunity HTTP/1.1
Host: sandbox-api.espay.id
Connection: keep-alive
Content-Length: 250
Content-Type: application/json
Accept: */*

{
    "rq_uuid": "9877897969869600016",
    "rq_datetime": "2025-01-20T08:41:41+07:00",
    "senderId": "CONTOH",
    "data": {
        "merchantId": "TOKOKUSHOPPING",
        "merchantName": "TOKOKU SHOPPING",
        "publicKeyIqos": "",
        "productChannels": [
            "QRIS", 
            "EDCBRI",
            "EDCBRIQRIS"
        ]
    }
}

















Sample Response

{
    "responseCode": "0000",
    "responseMessage": "Success",
    "data": {
        "apiKey": "6c470b943ee84d9814a8da2d0d07475d",
        "merchantCode": "SGWTTOKOKUSHOPPING",
        "merchantName": "TOKOKU SHOPPING",
        "password": "ZSSGIHQF",
        "signatureKey": "h4ce38pny4twf00c",
        "productChannels": [
            "AKULAKU",
            "ALFAMARTESPAY",
            "ARTHAGRAHAATM",
            "BANKDKIATM",
            "BANKSAQUATM",
            "BANKSINARMASATM",
            "BANKSUMSELBABELATM",
            "BCAATM",
            "BIIATM",
            "BNCATM",
            "BNIATM",
            "BRIATM",
            "BRIQR",
            "BSIATM",
            "BSQUDIRECTDEBIT",
            "BTNATM",
            "BTPNATM",
            "CIMBATM",
            "CREDITCARD",
            "DANA",
            "DANAMONATM",
            "DBSATM",
            "EDCWS",
            "EPAYBRI",
            "INAISSUER",
            "INDODANA",
            "INDOMARETESPAY",
            "KREDIVO",
            "LINKAJAAPPLINK",
            "LINKAJAQRPAY",
            "MANDIRIATM",
            "MASPIONATM",
            "OCBCATM",
            "OVO",
            "PERMATAATM",
            "QRISPLUS",
            "SALDOMUDIRECTDEBIT",
            "SALDOMUQR",
            "SEABANKATM",
            "SHOPEEJUMPPAY",
            "SHOPEEQRPAY"
        ],
        "paymentUrl": "https://wp2.gilangtester.my.id/wp-content/plugins/espay-sgo/payment.php",
        "publicKeyEspay": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2O9xDMTBiZ5oOy3LBVn6\nTerxWMHEwxl6gr0SX1dRt4be5vq2voFMoCHokeowqpeU5ZQi0EM36W7Q1K8hH6KR\njdNqhdIHyMh7X0yhVJTQ3Fz9QcjBfeMwoovmIYHP+U08GKz7j99VojSSriYvzT1m\nPdwvTuAdFT3QEXfgdMLKQCjtXF/eyg2Q+xCYJALv+zeaPlsu00RO3TM5NGaCSbFC\noF/xa4IOfV+215beBvl1fUhW6mkEo7gdhK8T0ddk5bInEJs3YzDwQNtAutLEFVot\nEKX2ETqIk8S1H7Pou7tSo73O0fFGaSBhG610bKIb9lLTXCQYJKk8bygPaL3aoT+5\nQwIDAQAB\n-----END PUBLIC KEY-----",
        "inquiryUrl": "http://localhost:813/dummyserver/snapv1dummy/inquirysnap",
        "settlementUrl": ""
    }
}


CURL


curl --location 'https://sandbox-api.espay.id/rest/merchanttools/registercommunity' \
--header 'Content-Type: application/json' \
--data '{
    "rq_uuid": "9877897969869600016",
    "rq_datetime": "2025-01-20T08:41:41+07:00",
    "senderId": "CONTOH",
    "data": {
        "merchantId": "TOKOKUSHOPPING",
        "merchantName": "TOKOKU SHOPPING",
        "publicKeyIqos": "",
        "productChannels": [
            "QRIS", 
            "EDCBRI",
            "EDCBRIQRIS"
        ]
    }
}'
Scroll to Top