ShopeePay

Integration Steps

Here is the overview of how to integrate with ShopeePay :

1. Payment

2. Acknowledge Payment Notification

1. Payment

To do payment using ShopeePay, you will need to hit this API through your backend :

Payment Jump App Merchant Interface

Merchant interface for payment jump App Dana SNAP

POSThttps://virtserver.swaggerhub.com/DOKUTECHNOLOGY/Merchant-Interface/1.0.0/direct-debit/merchant/shopeepay/v1.0/debit/payment-host-to-host

Header parameters

Body

application/json

partnerReferenceNo*string

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

amountobject

urlParamarray of object

validUpTostring (date)

Order Valid Up To | format: date

additionalInfoobject

Response

200400401

Payment successful

Body

application/json

responseCodestring

responseMessagestring

referenceNostring

partnerReferenceNostring

webRedirectUrlstring

Request

JavaScriptCurl

const response = await fetch('https://virtserver.swaggerhub.com/DOKUTECHNOLOGY/Merchant-Interface/1.0.0/direct-debit/merchant/shopeepay/v1.0/debit/payment-host-to-host', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "partnerReferenceNo": "INV_20221221_0002"
    }),
});
const data = await response.json();

Response

{
  "responseCode": "20054000",
  "responseMessage": "Successfull",
  "referenceNo": "20231011111212800110166670701279462",
  "partnerReferenceNo": "INV2023101102",
  "webRedirectUrl": "https://pjsp.com/universal?bizNo=REF9"
}

2. Acknowledge Payment Notification

After the payment is being made by your customer, DOKU will send HTTP Notification to your defined Notification URL. Learn how to handle the notification from DOKU .

Additional Feature

Online Refund

Refund Merchant Interface

Merchant interface for Refund Dana SNAP

POSThttps://virtserver.swaggerhub.com/DOKUTECHNOLOGY/Merchant-Interface/1.0.0/direct-debit/merchant/shopeepay/v1.0/debit/refund

Header parameters

Body

application/json

JSON request body for refunding a direct debit payment

originalPartnerReferenceNo*string

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

partnerRefundNo*string

Partner Refund Number | min length: 1 | max length: 64

originalExternalId*string

Original External Id | min length: 1 | max length: 36

reasonstring

Reason of refund | max length: 256

refundAmountobject

Response

200400401

Refund successful

Body

application/json

responseCodestring

responseMessagestring

refundNostring

partnerRefundNostring

refundAmountobject

refundTimestring

additionalInfoobject

Request

JavaScriptCurl

const response = await fetch('https://virtserver.swaggerhub.com/DOKUTECHNOLOGY/Merchant-Interface/1.0.0/direct-debit/merchant/shopeepay/v1.0/debit/refund', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "originalPartnerReferenceNo": "Testing-123",
      "partnerRefundNo": "20230915123232",
      "originalExternalId": "20230926103436"
    }),
});
const data = await response.json();

Response

{
  "responseCode": "20058000",
  "responseMessage": "Successful",
  "refundNo": "Refund-123123",
  "partnerRefundNo": "Refund-test123",
  "refundAmount": {
    "value": "12345678.00",
    "currency": "IDR"
  },
  "refundTime": "2022-07-20T07:00:00+07:00",
  "additionalInfo": {
    "createTime": "2022-07-20T07:00:00+07:00",
    "latestTransactionStatus": "00"
  }
}