OVERVIEW
API Direct Debit
.png)
Sequence Diagram Redirect (web check out with otp)
.png)
Sequence Diagram Redirect (web check out without otp)
Sequence Diagram API Direct Debit-Payment Host to Host
Sequence Diagram API Direct Debit-App Link
Informasi Umum
| Service Code | 54 |
|---|---|
| Name | API Direct Debit Payment |
| Version | 1.0 |
| HTTP Method | POST |
| Path | .../{version}/debit/payment-host-to-host |
Informasi Umum
| Service Code | 55 |
|---|---|
| Name | API Direct Debit Payment Status |
| Version | 1.0 |
| HTTP Method | POST |
| Path | .../{version}/debit/status |
Informasi Umum
| Service Code | 56 |
|---|---|
| Name | API Direct Debit Payment Notify |
| Version | 1.0 |
| HTTP Method | POST |
| Path | .../{version}/debit/notify |
Informasi Umum
| Service Code | 57 |
|---|---|
| Name | API Direct Debit Payment Cancel |
| Version | 1.0 |
| HTTP Method | POST |
| Path | .../{version}/debit/cancel |
Informasi Umum
| Service Code | 58 |
|---|---|
| Name | API Direct Debit Payment Refund |
| Version | 1.0 |
| HTTP Method | POST |
| Path | .../{version}/debit/refund |
GUIDES
Spesifikasi Parameter Header dan Body API Direct Debit
Request Body
| Parameter | Data Type | Mandatory | Length | Description |
|---|---|---|---|---|
| partnerReferenceNo | String | M | 64 | Transaction identifier on service consumer system |
| bankCardToken | String | O | ||
| chargeToken | String | M | 40 | string code for verification OTP |
| otp | String | O | 8 | OTP Code / Passcode |
| otpTrxCode | String | O | 2 | Purpose of otp |
| merchantId | String | O | 64 | Merchant identifier that is |
| unique per each merchant | ||||
| terminalId | String | O | 64 | Terminal ID |
| journeyId | String | O | 64 | Merchant ID |
| subMerchantId | String | O | 32 | Sub merchant ID |
| amount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Net amount of the transaction. |
| If it's IDR then value includes 2 decimal digits. | ||||
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| urlParam | Array of Object | O | ||
| url | string | M | 512 | The URL |
| type | string | M | 32 | URL Type |
| PAY_RETURN/PAY_NOTIFY | ||||
| isDeeplink | string | M | 1 | Whther the URL is a deeplink URL or not |
| Y/N | ||||
| externalStoreId | string | O | 64 | Store ID to indicate to which store |
| this payment belongs to. | ||||
| validUpTo | string | O | 25 | The time when the payment will be automatically expired. |
| ISO 8601 | ||||
| pointOfInitiation | String | O | 20 | used for getting more info regarding source of request of the user |
| feeType | String | O | 25 | to whom the fee will be charged |
| disabledPayMethods | String | O | 64 | Payment method(s) that cannot be used for this payment |
| payOptionDetails | Array of | O | Payment option that will be used for this payment | |
| Object | ||||
| payMethod | String | M | 64 | Payment Method. e.g. CREDIT_CARD |
| payOption | String | M | 64 | Payment option which shows the provider of this payment |
| e.g. CREDIT_CARD_VISA | ||||
| transAmount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Transaction amount that will be paid using this payment method If it's IDR then value includes 2 decimal digits. |
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| feeAmount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Fee amount that will be paid using this payment method If it's IDR then value includes 2 decimal digits. |
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| cardToken | String | O | 64 | Card token used for this payment. |
| merchantToken | String | O | 64 | Merchant token used for this payment. |
| additionalInfo | Object | O | Additional information | |
| additionalInfo | Object | O | Additional information |
Response Body
| Parameter | Data Type | Mandatory | Length | Description |
|---|---|---|---|---|
| responseCode | String | M | 7 | Response code |
| responseMessage | String | M | 150 | Response description |
| referenceNo | String | C | 64 | Transaction identifier on service provider system. Must be filled upon successful transaction |
| partnerReferenceNo | String | O | 64 | Transaction identifier on service consumer system |
| approvalCode | String | O | 20 | |
| appRedirectUrl | string | O | 2048 | Returns an URL scheme to PJP AIS payment page in native app. |
| webRedirectUrl | Returns a universal link to PJP AIS payment page. This link is recommended when the Client is unable to implement a | |||
| check for whether PJP AIS app is installed on the user's device before redirect. | ||||
| additionalInfo | Object | O | Additional information |
Request Body
| Key | Value | Mandatory | Length | Description |
|---|---|---|---|---|
| originalPartnerReferenceNo | String | O | 64 | Original transaction identifier on service consumer system |
| originalReferenceNo | String | O | 64 | Original transaction identifier on service provider system |
| originalExternalId | String | O | 32 | Original External-ID on header message |
| serviceCode | String | M | 2 | Transaction type indicator (service code of the original transaction request) |
| transactionDate | String | O | 25 | transaction date : ISO 8601 |
| amount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Net amount of the transaction. |
| If it's IDR then value includes 2 decimal digits. | ||||
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| merchantId | String | O | 64 | Merchant identifier that is |
| unique per each merchant | ||||
| subMerchantId | String | O | 32 | Sub merchant ID |
| externalStoreId | String | O | 64 | External Store ID for merchant |
| additionalInfo | Object | O | Additional information |
Response Body
| Parameter | Data Type | Mandatory | Length | Description |
|---|---|---|---|---|
| responseCode | String | M | 7 | Response code |
| responseMessage | String | M | 150 | Response description |
| originalReferenceNo | String | C | 64 | Original transaction identifier on service provider system. Must be filled upon successful transaction |
| originalPartnerReferenceNo | String | O | 64 | Original transaction identifier on service consumer system |
| approvalCode | String | O | 20 | |
| originalExternalId | String | O | 32 | Original External-ID on header message |
| serviceCode | String | M | 2 | Transaction type indicator (service code of the original transaction request) |
| latestTransactionStatus | String | M | 2 | 00 - Success |
| 01 - | ||||
| Initiated | ||||
| 02 - Paying | ||||
| 03 - Pending | ||||
| 04 - Refunded | ||||
| 05 - Canceled | ||||
| 06 - Failed | ||||
| 07 - Not found | ||||
| transactionStatusDesc | String | O | 50 | Description status transaction |
| originalResponseCode | String | O | 7 | Response code |
| originalResponseMessage | String | O | 150 | Response description |
| sessionId | String | O | 25 | Transaction invoice ID |
| requestID | String | O | 25 | Transaction request ID |
| refundHistory | Array of Object | O | ||
| refundNo | String | C | 64 | Transaction Identifier on Service Provider System |
| partnerRefundNo | String | M | 64 | ReferenceNumber from PJP AIS for the refund. |
| refundAmount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Net amount of the refund. |
| currency | String | M | 3 | Currency |
| refundStatus | String | M | 2 | 00 - Success |
| 03 - Pending | ||||
| 06 - Failed | ||||
| refundDate | String | C | 25 | (ISO 8601) |
| transaction date : | ||||
| dd-MM-yyyy (Mandatory) | ||||
| HH:mm:ss | ||||
| (Optional) | ||||
| reason | String | O | 256 | Refund reason. |
| transAmount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Transaction amount that will be paid using this payment method If it's IDR then value includes 2 decimal digits. |
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| feeAmount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Fee amount that will be paid using this payment method If it's IDR then value includes 2 decimal digits. |
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| paidTime | String | C | 25 | transaction date : ISO 8601 |
| additionalInfo | Object | O | Additional information |
Request Body
| Key | Value | Mandatory | Length | Description |
|---|---|---|---|---|
| originalPartnerReferenceNo | String | O | 64 | Original transaction identifier on service consumer system |
| originalReferenceNo | String | M | 64 | Original transaction identifier on service provider system |
| originalExternalId | String | O | 32 | Original Customer |
| Reference Number | ||||
| merchantId | String | O | 64 | Merchant identifier that is |
| unique per each merchant | ||||
| subMerchantId | String | O | 32 | Sub merchant ID |
| amount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Net amount of the transaction. |
| If it's IDR then value includes 2 decimal digits. | ||||
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| latestTransactionStatus | String | M | 2 | 00 - Success |
| 01 - Initiated | ||||
| 02 - Paying | ||||
| 03 - Pending | ||||
| 04 - Refunded | ||||
| 05 - Canceled | ||||
| 06 - Failed | ||||
| 07 - Not found | ||||
| transactionStatusDesc | String | O | 50 | Description status transaction |
| createdTime | string | O | 25 | Transaction created time. |
| finishedTime | string | O | 25 | Transaction finished time. |
| externalStoreID | String | O | 64 | External Store ID |
| additionalInfo | Object | O | Additional information |
Response Body
| Parameter | Data Type | Mandatory | Length | Description |
|---|---|---|---|---|
| responseCode | String | M | 7 | Response code |
| approvalCode | String | O | 20 | |
| responseMessage | String | M | 150 | Response description |
Request Body
| Key | Value | Mandatory | Length | Description |
|---|---|---|---|---|
| originalpartnerReferenceNo | String | M | 64 | Transaction identifier on service consumer system |
| originalReferenceNo | String | O | 64 | Original transaction identifier on service provider system |
| approvalCode | String | O | 20 | |
| originalExternalId | String | O | 32 | Original External-ID on header message |
| merchantId | String | O | 64 | Merchant identifier that is |
| unique per each merchant | ||||
| subMerchantId | String | O | 32 | Sub merchant ID |
| reason | String | O | 256 | Cancellation reason. |
| externalStoreID | String | O | 64 | External Store ID |
| amount | Object | O | ||
| Value | String (ISO4217) | M | 16,2 | Transaction Amount |
| Currency | String | M | 3 | Currency |
| additionalInfo | Object | O | Additional information |
Response Body
| Parameter | Data Type | Mandatory | Length | Description |
|---|---|---|---|---|
| responseCode | String | M | 7 | Response code |
| responseMessage | String | M | 150 | Response description |
| originalPartnerReferenceNo | String | O | 64 | Original transaction identifier on service consumer system |
| originalReferenceNo | String | C | 64 | Original transaction identifier on service provider system |
| originalExternalId | String | O | 32 | Original External-ID on header message |
| cancelTime | String | C | 25 | Cancel time |
| ISO-8601. Must be filled if cancelled transaction success | ||||
| transactionDate | yyyyMMddHHmmss | O | 255 | Transaction date |
| additionalInfo | Object | O | Additional information |
Request Body
| Key | Value | Mandatory | Length | Description |
|---|---|---|---|---|
| merchantId | String | O | 64 | Merchant identifier that is |
| unique per each merchant | ||||
| subMerchantId | String | O | 32 | Sub merchant ID |
| originalPartnerReferenceNo | String | M | 64 | Original transaction identifier on service consumer system |
| originalReferenceNo | String | O | 64 | Original transaction identifier on service provider system |
| originalExternalId | String | O | 32 | Original Customer |
| Reference Number | ||||
| partnerRefundNo | String | M | 64 | ReferenceNumber from PJP AIS for the refund. |
| refundAmount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Net amount of the refund. |
| If it's IDR then value includes 2 decimal digits. | ||||
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| externalStoreID | String | O | 64 | External Store ID |
| reason | String | O | 256 | Refund reason. |
| additionalInfo | Object | O |
Response Body
| Parameter | Data Type | Mandatory | Length | Description |
|---|---|---|---|---|
| responseCode | String | M | 7 | Response code |
| responseMessage | String | M | 150 | Response description |
| originalPartnerReferenceNo | String | O | 64 | Original transaction identifier on service consumer system |
| originalReferenceNo | String | C | 64 | Original transaction identifier on service provider system |
| originalExternalId | String | O | 32 | Original Customer |
| Reference Number | ||||
| partnerTrxId | String | O | 32 | Partner Transaction ID |
| refundNo | String | M | 64 | referenceNumber |
| partnerRefundNo | String | M | 64 | ReferenceNumber from PJP AIS for the refund. |
| refundAmount | Object | O | ||
| value | String (ISO4217) | M | 16,2 | Net amount of the refund. |
| If it's IDR then value includes 2 decimal digits. | ||||
| e.g. IDR 10.000,- will be placed with 10000.00 | ||||
| currency | String | M | 3 | Currency |
| refundTime | String | M | 25 | Refund time. |
| ISO 8601 | ||||
| additionalInfo | Object | O |
CODE SNIPPETS
Code Snippets API Direct Debit
Sample Request
POST .../v1.0/debit/payment-host-to-host HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
Authorization-Customer: Bearer fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP: 2020-12-23T07:44:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
X-IP-ADDRESS: 172.24.281.24
X-DEVICE-ID: 09864ADCASA
X-LATITUDE: -6.1617169
X-LONGITUDE: 106.6643946
CHANNEL-ID: 95221
{
"partnerReferenceNo":"2020102900000000000001",
"bankCardToken":"00007100010926",
"chargeToken":"00007100010926",
"otp":"12345678",
"merchantId":"23489182303312",
"terminalId":"489182303312",
"journeyId":"861023713017210",
"subMerchantId":"310928924949487",
"amount":{
"value":"12345678.00",
"currency":"IDR"
},
"urlParam":[
{
"url":"https://test1.bi.go.id/v1/test",
"type":"PAY_RETURN",
"isDeeplink":"Y"
},
{
"url":"https://test2.bi.go.id/v1/test",
"type":"PAY_RETURN",
"isDeeplink":"Y"
}
],
"externalStoreId":"239840198240795109",
"validUpTo":"2020-12-23T07:44:11+07:00",
"pointOfInitiation":"Mobile App",
"feeType":"SHA|1000",
"disabledPayMethods":"CREDIT_CARD",
"payOptionDetails":[
{
"payMethod":"CREDIT_CARD",
"payOption":"CREDIT_CARD_VISA",
"transAmount":{
"value":"12345678.00",
"currency":"IDR"
},
"feeAmount":{
"value":"12345678.00",
"currency":"IDR"
},
"cardToken":"d89ca90ua90sd80as9809",
"merchantToken":"a90ua90sd80d89cas9809",
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
},
{
"payMethod":"CREDIT_CARD",
"payOption":"CREDIT_CARD_MASTER",
"transAmount":{
"value":"12345678.00",
"currency":"IDR"
},
"feeAmount":{
"value":"12345678.00",
"currency":"IDR"
},
"cardToken":"d89ca90ua90sd80as9809",
"merchantToken":"a90ua90sd80d89cas9809",
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
}
],
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
}
Sample Response
Content-type: application/json
X-TIMESTAMP: 2020-12-23T07:44:16+07:00
{
"responseCode":"20054000",
"responseMessage":"Request has been processed successfully",
"referenceNo":"2020102977770000000009",
"partnerReferenceNo":"2020102900000000000001",
"approvalCode":"201039000200",
"appRedirectUrl":"https://pjsp.com/app?bizNo=REF993883&...",
"webRedirectUrl":"https://pjsp.com/universal?bizNo=REF993883&...",
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
}
Sample Request
POST .../v1.0/debit/status HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
Authorization-Customer: Bearer fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP: 2020-12-23T07:44:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
X-IP-ADDRESS: 172.24.281.24
X-DEVICE-ID: 09864ADCASA
X-LATITUDE: -6.1617169
X-LONGITUDE: 106.6643946
CHANNEL-ID: 95221
{
"originalPartnerReferenceNo":"2020102900000000000001",
"originalReferenceNo":"2020102977770000000009",
"originalExternalId":"30443786930722726463280097920912",
"serviceCode":"17",
"transactionDate":"2020-12-21T14:56:11+07:00",
"amount":{
"value":"12345678.00",
"currency":"IDR"
},
"merchantId":"23489182303312",
"subMerchantId":"23489182303312",
"externalStoreId":"183908924912387",
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
}
Sample Response
Content-type: application/json
X-TIMESTAMP: 2020-12-23T07:44:16+07:00
{
"responseCode":"2005500",
"responseMessage":"Request has been processed successfully",
"originalPartnerReferenceNo":"2020102900000000000001",
"originalReferenceNo":"2020102977770000000009",
"approvalCode":"201039000200",
"originalExternalId":"30443786930722726463280097920912",
"serviceCode":"17",
"latestTransactionStatus":"00",
"transactionStatusDesc":"success",
"originalResponseCode":"2005500",
"originalResponseMessage":"Request has been processed successfully",
"sessionId":"883737GHY8839",
"requestID":"3763773",
"refundHistory":[
{
"refundNo":"96194816941239812",
"partnerReferenceNo":"239850918204981205970",
"refundAmount":{
"value":"12345678.00",
"currency":"IDR"
},
"refundStatus":"00",
"refundDate":"2020-12-23T07:44:16+07:00",
"reason":"Customer Complain"
},
{
"refundNo":"96194123981251341",
"partnerReferenceNo":"2398509123131981205970",
"refundAmount":{
"value":"112345678.00",
"currency":"IDR"
},
"refundStatus":"00",
"refundDate":"2020-12-23T07:54:16+07:00",
"reason":"Customer Complain"
}
],
"transAmount":{
"value":"112345678.00",
"currency":"IDR"
},
"feeAmount":{
"value":"112345678.00",
"currency":"IDR"
},
"paidTime":"2020-12-21T14:56:11+07:00",
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
}
Sample Request
POST .../v1.0/debit/notify HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
Authorization-Customer: Bearer fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP: 2020-12-23T07:44:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
X-IP-ADDRESS: 172.24.281.24
X-DEVICE-ID: 09864ADCASA
X-LATITUDE: -6.1617169
X-LONGITUDE: 106.6643946
CHANNEL-ID: 95221
{
"originalPartnerReferenceNo":"2020102900000000000001",
"originalReferenceNo":"2020102977770000000009",
"originalExternalId":"30443786930722726463280097920912",
"merchantId":"23489182303312",
"subMerchantId":"23489182303312",
"amount":{
"value":"10000.00",
"currency":"IDR"
},
"latestTransactionStatus":"00",
"transactionStatusDesc":"success",
"createdTime":"2020-12-21T17:07:18+07:00",
"finishedTime":"2020-12-21T17:07:20+07:00",
"externalStoreId":"91863213913112",
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
}
Sample Response
Content-type: application/json
X-TIMESTAMP: 2020-12-23T07:44:16+07:00
{
"responseCode":"2005600",
"approvalCode":"201039000200",
"responseMessage":"Request has been processed successfully"
}
Sample Request
POST .../v1.0/debit/cancel HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
Authorization-Customer: Bearer fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP: 2020-12-23T07:44:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
X-IP-ADDRESS: 172.24.281.24
X-DEVICE-ID: 09864ADCASA
X-LATITUDE: -6.1617169
X-LONGITUDE: 106.6643946
CHANNEL-ID: 95221
{
"originalPartnerReferenceNo":"2020102900000000000001",
"originalReferenceNo":"2020102977770000000009",
"approvalCode":"201039000200",
"originalExternalId":"30443786930722726463280097920912",
"merchantId":"23489182303312",
"subMerchantId":"23489182303312",
"reason":"Network timeout",
"externalStoreId":"124928924949487",
"amount":{
"value":"10000.00",
"currency":"IDR"
},
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
}
Sample Response
Content-type: application/json
X-TIMESTAMP: 2020-12-23T07:44:16+07:00
{
"responseCode":"2005700",
"responseMessage":"Request has been processed successfully",
"originalPartnerReferenceNo":"2020102900000000000001",
"originalReferenceNo":"2020102977770000000009",
"originalExternalId":"30443786930722726463280097920912",
"cancelTime":"2020-12-21T17:07:25+07:00",
"transactionDate":"2020-12-21T17:55:11+07:00",
"additionalInfo":{
"deviceId":"12345679237",
"channel":"mobilephone"
}
}
Sample Request
POST .../v1.0/debit/refund HTTP/1.2
Content-type: application/json
Authorization: Bearer gp9HjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
Authorization-Customer: Bearer fa8sjjEj813Y9JGoqwOeOPWbnt4CUpvIJbU1mMU4a11MNDZ7Sg5u9a"
X-TIMESTAMP: 2020-12-23T07:44:11+07:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
ORIGIN: www.hostname.com
X-PARTNER-ID: 82150823919040624621823174737537
X-EXTERNAL-ID: 41807553358950093184162180797837
X-IP-ADDRESS: 172.24.281.24
X-DEVICE-ID: 09864ADCASA
X-LATITUDE: -6.1617169
X-LONGITUDE: 106.6643946
CHANNEL-ID: 95221
{
"merchantId":"00007100010926",
"subMerchantId":"310928924949487",
"originalPartnerReferenceNo":"2020102900000000000001",
"originalReferenceNo":"2020102977770000000009",
"originalExternalId":"10052019",
"partnerRefundNo":"239850918204981205970",
"refundAmount":{
"value":"10000.00",
"currency":"IDR"
},
"externalStoreId":"124928924949487",
"reason":"Customer complain",
"additionalInfo":null
}
Sample Response
Content-type: application/json
X-TIMESTAMP: 2020-12-23T07:44:16+07:00
{
"responseCode":"2005800",
"responseMessage":"Request has been processed successfully",
"originalPartnerReferenceNo":"2020102900000000000001",
"originalReferenceNo":"2020102977770000000009",
"originalExternalId":"10052019",
"partnerTrxId":"LA001",
" refundNo":"REF993883",
"partnerRefundNo":"239850918204981205970",
"refundAmount":{
"value":"10000.00",
"currency":"IDR"
},
"refundTime":"2020-12-21T17:21:41+07:00",
"additionalInfo":null
}
RESPONSES CODE
Response status merupakan informasi yang diberikan oleh service provider kepada service consumer pada response body, sebagai indikasi hasil dari pemrosesan request yang diterima.
Response status terdiri dari 2 komponen, yaitu kode (response code) dan deskripsinya (response message).
| Komponen | Tipe Data | Length | Keterangan |
|---|---|---|---|
| responseCode | String | 7 | response code = HTTP status code + service code + case code |
| responseMessage | String | 150 |
Daftar Response Code
| Category | HTTP Code | Service Code | Case Code | Response Message | Description |
|---|---|---|---|---|---|
| Success | 200 | any | 00 | Successful | Successful |
| Success | 202 | any | 00 | Request In Progress | Transaction still on process |
| System | 400 | any | 00 | Bad Request | General request failed error, including message parsing failed. |
| Message | 400 | any | 01 | Invalid Field Format {field name} | Invalid format |
| Message | 400 | any | 02 | Invalid Mandatory Field {field name} | Missing or invalid format on mandatory field |
| System | 401 | any | 00 | Unauthorized. [reason] | General unauthorized error (No Interface Def, API is Invalid, Oauth Failed, Verify Client Secret Fail, Client Forbidden Access API, Unknown Client, Key not Found) |
| System | 401 | any | 01 | Invalid Token (B2B) | Token found in request is invalid (Access Token Not Exist, Access Token Expiry) |
| System | 401 | any | 02 | Invalid Customer Token | Token found in request is invalid (Access Token Not Exist, Access Token Expiry) |
| System | 401 | any | 03 | Token Not Found (B2B) | Token not found in the system. This occurs on any API that requires token as input parameter |
| System | 401 | any | 04 | Customer Token Not Found | Token not found in the system. This occurs on any API that requires token as input parameter |
| Business | 403 | any | 00 | Transaction Expired | Transaction expired |
| System | 403 | any | 01 | Feature Not Allowed [Reason] | This merchant is not allowed to call Direct Debit APIs |
| Business | 403 | any | 02 | Exceeds Transaction Amount Limit | Exceeds Transaction Amount Limit |
| Business | 403 | any | 03 | Suspected Fraud | Suspected Fraud |
| Business | 403 | any | 04 | Activity Count Limit Exceeded | Too many request, Exceeds Transaction Frequency Limit |
| Business | 403 | any | 05 | Do Not Honor | Account or User status is abnormal |
| System | 403 | any | 06 | Feature Not Allowed At This Time. [reason] | Cut off In Progress |
| Business | 403 | any | 07 | Card Blocked | The payment card is blocked |
| Business | 403 | any | 08 | Card Expired | The payment card is expired |
| Business | 403 | any | 09 | Dormant Account | The account is dormant |
| Business | 403 | any | 10 | Need To Set Token Limit | Need to set token limit |
| System | 403 | any | 11 | OTP Blocked | OTP has been blocked |
| System | 403 | any | 12 | OTP Lifetime Expired | OTP has been expired |
| System | 403 | any | 13 | OTP Sent To Cardholer | initiates request OTP to the issuer |
| Business | 403 | any | 14 | Insufficient Funds | Insufficient Funds |
| Business | 403 | any | 15 | Transaction Not Permitted.[reason] | Transaction Not Permitted |
| Business | 403 | any | 16 | Suspend Transaction | Suspend Transaction |
| Business | 403 | any | 17 | Token Limit Exceeded | Purchase amount exceeds the token limit set prior |
| Business | 403 | any | 18 | Inactive Card/Account/Customer | Indicates inactive account |
| Business | 403 | any | 19 | Merchant Blacklisted | Merchant is suspended from calling any APIs |
| Business | 403 | any | 20 | Merchant Limit Exceed | Merchant aggregated purchase amount on that day exceeds the agreed limit |
| Business | 403 | any | 21 | Set Limit Not Allowed | Set limit not allowed on particular token |
| Business | 403 | any | 22 | Token Limit Invalid | The token limit desired by the merchant is not within the agreed range between the merchant and the Issuer |
| Business | 403 | any | 23 | Account Limit Exceed | Account aggregated purchase amount on that day exceeds the agreed limit |
| Business | 404 | any | 00 | Invalid Transaction Status | Invalid transaction status |
| Business | 404 | any | 01 | Transaction Not Found | Transaction not found |
| System | 404 | any | 02 | Invalid Routing | Invalid Routing |
| System | 404 | any | 03 | Bank Not Supported By Switch | Bank not supported by switch |
| Business | 404 | any | 04 | Transaction Cancelled | Transaction is cancelled by customer |
| Business | 404 | any | 05 | Merchant Is Not Registered For Card Registration Services | Merchant is not registered for Card Registration services |
| System | 404 | any | 06 | Need To Request OTP | Need to request OTP |
| System | 404 | any | 07 | Journey Not Found | The journeyID cannot be found in the system |
| Business | 404 | any | 08 | Invalid Merchant | Merchant does not exist or status abnormal |
| Business | 404 | any | 09 | No Issuer | No issuer |
| System | 404 | any | 10 | Invalid API Transition | Invalid API transition within a journey |
| Business | 404 | any | 11 | Invalid Card/Account/Customer [info]/Virtual Account | Card information may be invalid, or the card account may be blacklisted, or Virtual Account number maybe invalid. |
| Business | 404 | any | 12 | Invalid Bill/Virtual Account [Reason] | The bill is blocked/ suspended/not found. |
| Virtual account is suspend/not found. | |||||
| Business | 404 | any | 13 | Invalid Amount | The amount doesn't match with what supposed to |
| Business | 404 | any | 14 | Paid Bill | The bill has been paid |
| System | 404 | any | 15 | Invalid OTP | OTP is incorrect |
| Business | 404 | any | 16 | Partner Not Found | Partner number can't be found |
| Business | 404 | any | 17 | Invalid Terminal | Terminal does not exist in the system |
| Business | 404 | any | 18 | Inconsistent Request | Inconsistent request parameter found for the same partner reference number/transaction id |
| It can be considered as failed in transfer debit, but it should be considered as success in transfer credit. | |||||
| Considered as success: | |||||
| - Transfer credit = (i) Intrabank transfer; (ii) Interbank transfer; (iii) RTGS transfer; (iv) SKNBI transfer; | |||||
| - Virtual account = (i) Payment VA; (ii) Payment to VA; | |||||
| - Transfer debit = (i) Refund payment; (ii) Void; | |||||
| Considered as failed: | |||||
| - Transfer credit = (i) Transfer to OTC; | |||||
| - Transfer debit = (i) Direct debit payment; (ii) QR CPM payment; (iii) Auth payment; (iv) Capture; | |||||
| Business | 404 | any | 19 | Invalid Bill/Virtual Account | The bill is expired. |
| Virtual account is expired. | |||||
| System | 405 | any | 00 | Requested Function Is Not Supported | Requested function is not supported |
| Business | 405 | any | 01 | Requested Opearation Is Not Allowed | Requested operation to cancel/refund transaction Is not allowed at this time. |
| System | 409 | any | 00 | Conflict | Cannot use same X-EXTERNAL-ID in same day |
| System | 409 | any | 01 | Duplicate partnerReferenceNo | Transaction has previously been processed indicates the same partnerReferenceNo already success |
| System | 429 | any | 00 | Too Many Requests | Maximum transaction limit exceeded |
| System | 500 | any | 00 | General Error | General Error |
| System | 500 | Any | 01 | Internal Server Error | Unknown Internal Server Failure, Please retry the process again |
| System | 500 | Any | 02 | External Server Error | Backend system failure, etc |
| System | 504 | any | 00 | Timeout | timeout from the issuer |
APLIKASI PENGUJIAN
Akses Terbatas, Mohon Sign Up untuk Dapat Mengakses Halaman Ini