Callback

IDSL will send response to your callback URL to inform you about prepaid transaction you did before. There are only two possible response that IDSL will send to your callback URL: success/failed response.

See here how to secure your callback

Production

In production environment, IDSL will send the response to your callback URL automatically.

Set your production callback URL here

Development

In development environment, IDSL don't send response automatically to your callback URL. You can simulate the response to your callback URL through sandbox report.

Set your development callback URL here

Learn more about sandbox report

Path

Method	Path
POST	Your callback URL

Response parameter

IDSL will send below response to your callback URL for both version 1 and version 2.

See the different between version 1 and 2 here

Field	Type	Description	Mandatory
ref_id	String	Your order number / reference ID (must unique)	Yes
status	String	Transaction status. List of status: `0:PROCESS` `1: SUCCESS` `2:FAILED`	Yes
code	String	Product Code	Yes
hp	String	Customer ID	Yes
price	String	Product price	Yes
message	String	Top Up message	Yes
sn	String	Serial number. See sn format	No
pin	String	Pin. Will only appear in several Games Vouchers	No
activation_code	String	Activation Code. Will only appear in Esim Product	No
balance	String	Final balance	Yes
tr_id	String	IDSL transaction ID	Yes
rc	String	IDSL response code. See rc list	Yes
sign	String	md5(username+api_key+ref_id)	Yes

Success Response Example

Below is the example of success response that will sent to your callback URL.

Game

JSON

{
  "data": {
    "ref_id": "order001",
    "status": "1",
    "code": "hsteam12000",
    "hp": "0817777215",
    "price": "16500",
    "message": "SUCCESS",
    "sn": "ABCD-EFGH-IJKL-MNOP",
    "pin": "123456789",
    "balance": "996994749",
    "tr_id": "3487",
    "rc": "00",
    "sign": "96e1028f6beaa817ee3670a39c01c69d"
  }
}

XML

<?xml version="1.0" encoding="UTF-8" ?>
<mp>
  <ref_id>order001</ref_id>
  <status>1</status>
  <code>hsteam12000</code>
  <hp>0817777215</hp>
  <price>16500</price>
  <message>SUCCESS</message>
  <sn>ABCD-EFGH-IJKL-MNOP</sn>
  <pin>123456789</pin>
  <balance>996994749</balance>
  <tr_id>3487</tr_id>
  <rc>00</rc>
  <sign>96e1028f6beaa817ee3670a39c01c69d</sign>
</mp>

Esim

JSON

{
  "data": {
    "ref_id": "order001",
    "status": "1",
    "code": "hsteam12000",
    "hp": "0817777215",
    "price": "16500",
    "message": "SUCCESS",
    "sn": "ABCD-EFGH-IJKL-MNOP",
    "activation_code": "LPA:1$v1-aktivasi-esim.com$9876543210123456789ABCDEFGHGFEDC",
    "balance": "996994749",
    "tr_id": "3487",
    "rc": "00",
    "sign": "96e1028f6beaa817ee3670a39c01c69d"
  }
}

XML

<?xml version="1.0" encoding="UTF-8" ?>
<mp>
  <ref_id>order001</ref_id>
  <status>1</status>
  <code>hsteam12000</code>
  <hp>0817777215</hp>
  <price>16500</price>
  <message>SUCCESS</message>
  <sn>ABCD-EFGH-IJKL-MNOP</sn>
  <activation_code>LPA:1$v1-aktivasi-esim.com$9876543210123456789ABCDEFGHGFEDC</activation_code>
  <balance>996994749</balance>
  <tr_id>3487</tr_id>
  <rc>00</rc>
  <sign>96e1028f6beaa817ee3670a39c01c69d</sign>
</mp>

Other Products

JSON

{
  "data": {
    "ref_id": "order002",
    "status": "1",
    "code": "xld25000",
    "hp": "0817777215",
    "price": "25000",
    "message": "SUCCESS",
    "sn": "123456789",
    "balance": "997061249",
    "tr_id": "3482",
    "rc": "00",
    "sign": "96e1028f6beaa817ee3670a39c01c69d"
  }
}

XML

<?xml version="1.0" encoding="UTF-8" ?>
<mp>
  <ref_id>order002</ref_id>
  <status>1</status>
  <code>xld25000</code>
  <hp>0817777215</hp>
  <price>25000</price>
  <message>SUCCESS</message>
  <sn>123456789</sn>
  <balance>997061249</balance>
  <tr_id>3482</tr_id>
  <rc>00</rc>
  <sign>96e1028f6beaa817ee3670a39c01c69d</sign>
</mp>

Failed Response Example

Below is the example of failed response that will sent to your callback URL.

JSON

{
  "data": {
    "ref_id": "order003",
    "status": "2",
    "code": "xld50000",
    "hp": "0817777215",
    "price": "50000",
    "message": "FAILED",
    "balance": "997011249",
    "tr_id": "3486",
    "rc": "07",
    "sign": "96e1028f6beaa817ee3670a39c01c69d"
  }
}

XML

<?xml version="1.0" encoding="UTF-8" ?>
<mp>
  <ref_id>order003</ref_id>
  <status>2</status>
  <code>xld50000</code>
  <hp>0817777215</hp>
  <price>50000</price>
  <message>FAILED</message>
  <balance>997011249</balance>
  <tr_id>3486</tr_id>
  <rc>07</rc>
  <sign>96e1028f6beaa817ee3670a39c01c69d</sign>
</mp>

PrepaidOperator Prefix List

PrepaidGame Format Request