Linkage

Account Inquiry

Account Inquiry is a service that can be used to check whether a merchant account has already been registered.
Type Value
Service Code
08
Name
API Account Binding Inquiry
HTTP Method
POST

Flow

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

API URL

Environment URL
Sandbox
Port of HTTPS (443)
https://sandbox-api.espay.id/apidirectdebit/v1.0/registration-account-inquiry
Production
Port of HTTPS (443)
https://api.espay.id/apidirectdebit/v1.0/registration-account-inquiry

Headers

Name Type Mandatory Description
Content-Type
String
Y
Content of your request body.

Example:
application/json
X-TIMESTAMP
String (25)
Y
Customer's current local date and time.

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

Example:
2024-03-14T07:49:28+07:00
X-SIGNATURE
String (255)
Y
Code used to validate transactions. Learn Payment Gateway | Asymmetric Signature
X-EXTERNAL-ID
String (32)
Y
Numeric String. Reference number that should be unique on the same day.
X-PARTNER-ID
String (50)
Y
Merchant Code from Espay team.

Example:
SGWYESSISHOP
CHANNEL-ID
String (5)
Y
Channel id.

Value:
Espay
Authorization-Customer
String (150)
C
Access Token B2B2C. Espay -> Bank
Y: Yes, O: Optional, C: Conditional

Request Parameters

Parameter Type Mandatory Description
partnerReferenceNo
String (64)
Y
Merchant reference code.
additionalInfo
Object
  productCode
String (16)
Y
Product code. See the list of product codes here.
  phoneNo
String (13)
Y
Customer mobile phone number.

Format:
62xxxxxxxxxxxx
  accountToken
string(64)
Y
The Account Token from account binding registration.
Y: Yes, O: Optional, C: Conditional

Response Parameters

Parameter Type Mandatory Description
responseCode
String (7)
Y
Response code. See response codes here.

Format:
Kode HTTP + Kode Layanan + Kode Error

Example:
200+08+00 = 2000800.
responseMessage
String (150)
Y
Response description. See response descriptions here.
AdditionalInfo
Object
  accountStatus
String (32)
Y
Account status.
  memberLevel
String (1)
Y
Account level status.
  message
String (128)
Y
Description.
Y: Yes, O: Optional, C: Conditional






























Sample Headers

Content-Type:application/json
X-TIMESTAMP:2024-03-14T07:49:28+07:00
X-SIGNATURE:jaCUbDOSIjFcDaZ1rO0aCczJrWSfV0wAXVi/zOLlOLOIVH00gucOSOnHpKTARwpnn6qB08Vi8VJviNhIQh1q6zVJAwdhxnHRlwNFa28IVFTtSmD4nXPWT3LsuYuFPNDGJ59/MgKMVjwIofYvq2dwOHoDi9rnyT3nPl7N2bRdIQceQlD6sITcqdEbRUlm+zTFB2MxNy4vFaEZz1LU8fsENp+giMNqxR26DsNcRj1K8JBXO6nY8q2m3jmTmiduXK5VZXxt/5v6bp+OlYCwJhn3hmdZD1zwC3Hu6qZcCIhO6IVe0ThSCfsaCdye9o/Ew6VdMWbTtQUoR983mq6MubLmzg==
X-EXTERNAL-ID:d3be5aec-155b-4b46-bfee-3fd55363d0f4
X-PARTNER-ID:SGWYESSISHOP
CHANNEL-ID:ESPAY






























Sample Request

{
    "partnerReferenceNo":"test00059",
    "additionalInfo":{
        "productCode":"SALDOMUDIRECTDEBIT",
        "phoneNo":"628777123456",
        "accountToken":"ESP230929094046rRD5mCT1IZkrBhJb5"
    }
}








Sample Positive Response

{
    "responseCode": "2000800",
    "responseMessage": "Successful",
    "additionalInfo": {
        "accountStatus": "ACTIVE",
        "memberLevel": "2",
        "message": ""
    }
}


Sample Negative Response

{
    "responseCode": "4090800",
    "responseMessage": "Duplicate X-EXTERNAL-ID"
}




CRUL

curl --location 'https://sandbox-api.espay.id/apidirectdebit/v1.0/registration-account-inquiry' \
--header 'Content-Type: application/json' \
--header 'X-TIMESTAMP: 2024-03-14T07:49:28+07:00' \
--header 'X-SIGNATURE: jaCUbDOSIjFcDaZ1rO0aCczJrWSfV0wAXVi/zOLlOLOIVH00gucOSOnHpKTARwpnn6qB08Vi8VJviNhIQh1q6zVJAwdhxnHRlwNFa28IVFTtSmD4nXPWT3LsuYuFPNDGJ59/MgKMVjwIofYvq2dwOHoDi9rnyT3nPl7N2bRdIQceQlD6sITcqdEbRUlm+zTFB2MxNy4vFaEZz1LU8fsENp+giMNqxR26DsNcRj1K8JBXO6nY8q2m3jmTmiduXK5VZXxt/5v6bp+OlYCwJhn3hmdZD1zwC3Hu6qZcCIhO6IVe0ThSCfsaCdye9o/Ew6VdMWbTtQUoR983mq6MubLmzg==' \
--header 'X-EXTERNAL-ID: a3046f47-a048-44d4-ab04-cbe57dcb63c8' \
--header 'X-PARTNER-ID: SGWYESSISHOP' \
--header 'CHANNEL-ID: ESPAY' \
--data '{
    "partnerReferenceNo":"test00059",
    "additionalInfo":{
        "productCode":"SALDOMUDIRECTDEBIT",
        "phoneNo":"628777123456"
    }
}'
Scroll to Top