Payment Gateway

Create Merchant ID

Create Merchant ID merupakan layanan opsional yang disediakan untuk membuat merchant code (commcode) secara mandiri.

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Espay Payment Gateway akan memberikan respons dalam bentuk JSON.

HTTP Header

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.espay.id/rest/merchanttools/registercommunity

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Universally Unique Identifier (UUID), nomor unik yang digunakan untuk mengidentifikasi pesan.
rq_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server merchant.

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

Contoh:
2025-01-20T08:41:41+07:00
sender_id
String (32)
Y
Kode pengirim yang diberikan oleh tim espay dan bersifat fix value.
data
JSON Object
  merchantId
String (20)
Y
Merchant code yang dikirimkan dari sisi merchant.

Contoh:
TOKOKUSHOPPING
  merchantName
String (64)
Y
Nama merchant yang dikirimkan dari sisi merchant.
  publicKeyIqos
RSA 2048
O
Public Key Iqos.
  productChannels
Array
Y
Channel bank yang akan digunakan.
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
responseCode
String (7)
Y
Kode respons.
responseMessage
String (150)
Y
Deskripsi respons.
data
Object
Y
  apiKey
String (32)
Y
API Key yang digenerate oleh Espay.
  merchantCode
String(20)
Y
Merchant code untuk call ke API Espay.

Contoh:
SGWTOKOKUSHOPPING
  merchantName
String (64)
Y
Nama merchant yang terdaftar di Espay.
  password
String (16)
Y
Password API untuk call ke API Espay.
  signatureKey
String (16)
Y
Signature API untuk call ke API Espay.
  productChannels
Array
Y
Channel bank yang dibuka oleh Espay.
  paymentUrl
String (255)
Y
Payment URL merchant yang terdaftar.
  publicKeyEspay
RSA 2048
Y
Public key Espay yang dapat digunakan merchant untuk validasi.
  inquiryUrl
String (255)
Y
Inquiry URL merchant yang terdaftar.
  settlementUrl
String (255)
Y
Settlement URL merchant yang terdaftar.
Y: Yes, O: Optional, C: Conditional





































Contoh Permintaan

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"
        ]
    }
}

















Contoh Respons

{
    "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