Know Your Customer (KYC)
Content
API Description
| API URL | https://apigw.tri.co.id/eai/verify_customer/query/kyc (NON-PROD) |
| API Name | POST |
| API Type | Query |
| Description | In this use case the intent is to identify/validate customer’s personal information.However due to data security compliance, no customer PII information can be exposed and therefore only acknowledgement result will only be given. |
API Parameters
HTTP Header
| Content Type | application/json |
Input Params
| api_key | An active unique api key registered by H3I to invoke your APIs. |
| sig | Signature, it contains (api_key + Secret + TimeStamp) MD5 Hash, TimeStamp is in UNIX format, refer Authentication section, for more details. |
Request Body
| txn_id | A unique transaction id generated by external developer/partner, length can be up to 25 charactors, e.g. MYAPP202005152034120001 |
| msisdn | Present phone number to check if sim swapped is done for this number |
Response Body
| code | Refer Error codes section |
| desc | Refer message in Error codes section |
| result | |
| - msisdn | Input MSISDN or phone number |
| - is_prepaid | Returns true if number is prepaid, else returns false. |
| - is_active | Returns true if number is active, else return false. |
| - is_valid | Return true if number is valid Tri MSISDN, else return false. |
Error Codes
| Codes | Message |
| 00000 | Success |
| 9999 | Unexpected system Error |
| 11111 | Error Process |
For a full list of generic HTTP error response codes, see Generic HTTP Error Response Codes.
Samples
Sample Request
{
"txn_id":"App12123123",
"msisdn":"62895712343123"
}
Sample Success Response
{
"code":"00000",
"desc":"Success",
"result":
{
"msisdn":"08967613408",
"is_prepaid":"true",
"is_active":"true",
"is_valid":"true"
}
}
Sample Fail Response
{
"code":"11111",
"desc":"Error Processing request"
}
Sample CURL
curl --request POST \
--url 'https://apigw.tri.co.id/eai/verify_customer/query/kyc?api_key=wrwx9kg72jyzx3u5zcmpwnzu' \
--header 'Content-Type: application/json' \
--data '{ "txn_id":"App20201223151030000", "msisdn":"06289123456"}'
Back
.
{
"code":"00000",
"desc":"Success",
"result":
{
"msisdn":"08967613408",
"is_prepaid":"true",
"is_active":"true",
"is_valid":"true"
}
}