Linkage

Account Unbinding

Account Unbinding is a service that deactivates or disconnects accounts from Direct Debit and Linkage services. It is used for security reasons, account changes, or to stop recurring automated payment processes. After the unbinding process, the accounts will no longer be linked, and any previously granted permissions or access will be revoked.
Type Value
Service Code
09
Name
API Account Unbinding
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/debit/registra tion-account-unbinding
Production
Port of HTTPS (443)
https://api.espay.id/apidirectdebit/v1.0/debit/registra tion-account-unbinding

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 Signatures Asymmetric
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
Original merchant order id / payment id.
merchantId
String (64)
Y
Partner service Id.

Value:
"ESPAY"
phoneNo
String (13)
O
Customer phone number.
authorizationCustomer
String (128)
C
B2B2C Token.
additionalInfo
Object
  productCode
String (16)
Y
Product code. Click here
  accountToken
String (64)
C
Registered Customer id.
Y: Yes, O: Optional, C: Conditional

Response Parameters

Parameter Type Mandatory Description
responseCode
String (7)
Y
Response Code.

Format:
HTTP Code + Service Code + Error Code

Example:
200+09+00 = 2000900.
responseMessage
String (150)
Y
Response description.
referenceNo
String (64)
Y
Reference for OTP verification.
AdditionalInfo
Object
Refresh Token if Access Token Expired
  message
String (128)
C
Description.
  verificationInfo
Object
    type
String (64)
Y
Type e.x = OTP.
    chargeToken
String (64)
Y
OTP Verification String.
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": "543654363643",
    "merchantId": "ESPAY",
    "phoneNo": "087XXXXXXX",
    "authorizationCustomer":"kSJ8StMgauL1R84LvbSgL2Bad5Xs89OpkHhJTunMTIgXPAC7vjVVge69", 
    "additionalInfo":{
        "productCode": "DANAMONDIRECTDEBIT",
        "accountToken": "ESP230908023716NykFMRWc2oEQ54RJj"
    }
}














Sample Response

{
    "responseCode": "2000900",
    "responseMessage": "Successful",
    "referenceNo": "EXT20230929030900011619",
    "additionalInfo": {
    "message": "",
        "verificationInfo": {
            "type": "OTP",
            "chargeToken": "1b7a365c-50f2-46f3-a9a1-481f1f21a4fa"
        }
    }
}


CURL

curl --location 'https://sandbox-api.espay.id/apidirectdebit/v1.0/debit/registration-account-unbinding
' \
--header 'X-TIMESTAMP: 2024-03-14T07:49:28+07:00' \
--header 'X-SIGNATURE: f4wSIUnO39AMbTdE7uD+kksnRzbCH2Af/WQNVFhk4IpCsSrnuBVCyl8TCnpWSnybGXtMfntreQn6y3bFiL9+vWojsTPCg+ljYrCocIGAoNkLyE+xg95Qg2Bbugn7f8Az1KAPUOyM3K7yLmgkIc7Xlzr3UK/O2BDGoTUs9N6Z1DFkHrlYYsi8DaXO6fslaM0eMtt1idCWk7Tkz5PBsYANVN8HP+DG73zWnxqgz7AR7RJZz34ahx+t3OIIWAS8BPWprA9+oSES1BZzIQcYUsjIfxul9e0Z1dUfOZB0VWCn2eqrUWzx3UNtLY+fzyYIl+87yAXJT129ypV+KyOql0EZzA==' \
--header 'X-EXTERNAL-ID: 93b3419d-2821-489e-b718-c0092ecc3ebf' \
--header 'X-PARTNER-ID: SGWDIGALLERY' \
--header 'CHANNEL-ID: ESPAY' \
--header 'Content-Type: application/json' \
--data '{
    "partnerReferenceNo":"543654363643",
    "merchantId":"ESPAY",
    "phoneNo":"0896227489011",
    "authorizationCustomer":"kSJ8StMgauL1R84LvbSgL2Bad5Xs89OpkHhJTunMTIgXPAC7vjVVge69",
    "additionalInfo":{
        "productCode":"DANAMONDIRECTDEBIT",
        "accountToken":"ESP230908023716NykFMRWc2oEQ54RJj"
    }
}'





Scroll to Top