HTTP Notification Sample for SNAP

HTTP Notification sample for SNAP Payment Methods

After setting up your Notification URL, we will send the notification for certain events such as when the Virtual Account has been paid by your customers, etc.

Once the customers finish the payment, DOKU will send the notification to your defined Notification URL.

Virtual Account

Here is the sample notification that DOKU will send to merchant's server. For Virtual Account SNAP has same sample notification.

The list of Virtual Account SNAP, you can find here.

Payment Notification

Payment Notification

POSThttps://{merchant-domain}/v1/transfer-va/payment

Header parameters

Body

application/json

Payment Notification SNAP request

partnerServiceId*string

similar to company code/BIN,8 digit left padding space. | min length: 1 | max length: 8

customerNo*string

Unique number (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | min length: 1 | max length: 20

virtualAccountNo*string

partnerServiceId (8 digit left padding 0) + customerNo (up to 20 digits). partnerServiceId + customerNo or virtualAccountNo. | min length: 1 | max length: 28

virtualAccountName*string

Customer Name | min length: 1 | max length: 255

trxId*string

Transaction ID in Partner system. | min length: 1 | max length: 64

paymentRequestIdstring

Unique identifier generated by PJP. If Payment comes from the Inquiry process, this value must be the same with inquiryRequestId. | min length: 1 | max length: 30

paidAmountTotalAmountRef (object)

virtualAccountEmailstring

Customer Email | min length: 1 | max length: 255

virtualAccountPhonestring

Customer Phone, Format: 62xxxxxxxxx xxxx | min length: 9 | max length: 30

Response

200400403404409500504

item created

Body

application/json

responseCode*string

Response Code with format HTTP status code + service code + case code. | min length: 1 | max length: 7

responseMessage*string

Response Description. | min length: 1 | max length: 150

virtualAccountData*object

Request

JavaScriptCurl

const response = await fetch('https://{merchant-domain}/v1/transfer-va/payment', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "partnerServiceId": "   77777",
      "customerNo": "0000000000001",
      "virtualAccountNo": "   777770000000000001",
      "virtualAccountName": "Toru Yamashita",
      "trxId": "23219829713"
    }),
});
const data = await response.json();

Response

{
  "responseCode": "2002500",
  "responseMessage": "Success",
  "virtualAccountData": {
    "partnerServiceId": "   77777",
    "customerNo": "0000000000001",
    "virtualAccountNo": "   777770000000000001",
    "virtualAccountName": "Toru Yamashita",
    "trxId": "23219829713",
    "paymentRequestId": "12839218738127830"
  }
}

Direct Debit

Here is the sample notification that DOKU will send to merchant's server. For Direct Debit SNAP has same sample notification.

The list of Direct Debit SNAP, you can find here.

Notify endpoint

POSThttps://{api-domain}/v1.0/debit/notify

Header parameters

Body

application/json

originalPartnerReferenceNo*string

Original Partner Reference Number | min length: 1 | max length: 64

originalReferenceNo*string

Original Reference Number | min length: 1 | max length: 64

originalExternalId*string

Original External ID from payment process | min length: 1 | max length: 64

latestTransactionStatus*string

latest transaction status of transaction | format: 00 (Success) / 03 (Pending) / 04 (Refunded) / 05 (Canceled) / 06 (Failed)

transactionStatusDesc*string

description of transaction status

amount*object

additionalInfo*object

Response

200

Success

Body

application/json

responseCode*string

approvalCode*string

responseMessage*string

Request

JavaScriptCurl

const response = await fetch('https://{api-domain}/v1.0/debit/notify', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "originalPartnerReferenceNo": "INVALLO201223002",
      "originalReferenceNo": "2023122000000002e21131",
      "originalExternalId": "660156703",
      "latestTransactionStatus": "00",
      "transactionStatusDesc": "Success",
      "amount": {},
      "additionalInfo": {}
    }),
});
const data = await response.json();

Response

{
  "responseCode": "2005600",
  "approvalCode": "201039000200",
  "responseMessage": "Request has been processed successfully"
}

E-wallet

The notification format for SNAP e-wallet transactions exhibits minor differences from those of other e-wallets. For further details please refer to sample notification below.

Notify endpoint

POSThttps://{api-domain}/v1.0/debit/notify

Header parameters

Body

application/json

originalPartnerReferenceNo*string

Original Partner Reference Number | min length: 1 | max length: 64

originalReferenceNo*string

Original Reference Number | min length: 1 | max length: 64

originalExternalId*string

Original External ID from payment process | min length: 1 | max length: 64

latestTransactionStatus*string

latest transaction status of transaction | format: 00 (Success) / 03 (Pending) / 04 (Refunded) / 05 (Canceled) / 06 (Failed)

transactionStatusDesc*string

description of transaction status

amount*object

additionalInfo*object

Response

200

Success

Body

application/json

responseCode*string

approvalCode*string

responseMessage*string

Request

JavaScriptCurl

const response = await fetch('https://{api-domain}/v1.0/debit/notify', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "originalPartnerReferenceNo": "INVALLO201223002",
      "originalReferenceNo": "2023122000000002e92112131",
      "originalExternalId": "660156703",
      "latestTransactionStatus": "00",
      "transactionStatusDesc": "Success",
      "amount": {},
      "additionalInfo": {}
    }),
});
const data = await response.json();

Response

{
  "responseCode": "2005600",
  "approvalCode": "201039000200",
  "responseMessage": "Request has been processed successfully"
}