ShopeePay

Integration Steps

Here is the overview of how to integrate with ShopeePay :

1. Payment

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

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 :

PreviousDANA NextDirect Debit

Last updated 6 months ago

Was this helpful?

Payment Jump App Merchant Interface

Merchant interface for payment jump App Dana SNAP

post

/direct-debit/merchant/shopeepay/v1.0/debit/payment-host-to-host

Header parameters

X-TIMESTAMPstring · utc timestamprequired

Client's current local time in yyyy-MM- ddTHH:mm:ssTZD format

Example: 2020-12-21T07:56:11.000Z

X-SIGNATUREstringrequired

Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)

Example: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5

X-PARTNER-IDstringrequired

Unique ID for a partner (DOKU'S Client ID)

Example: 821508239190

X-EXTERNAL-IDstringrequired

Numeric String. Reference number that should be unique in the same day (request-id)

Example: 418075533589

X-DEVICE-IDstringrequired

Device identification on which the API services are currently being accessed by the end user (customer). Can’t contain symbols

Example: 95221

X-IP-ADDRESSstring

conditional. IP address of the end user (customer) using IPv4 format

Example: 95221

Authorizationstringrequired

Access Token obtained from Get B2B Token API | Go to here for detailed documentation

Example:

Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ

Body

partnerReferenceNostringrequired

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

Example: INV_20221221_0002

validUpTostring · date

Order Valid Up To | format: date

Example: 2022-07-20T07:00:00+07:00

amountobject

urlParamobject[]

additionalInfoobject

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://virtserver.swaggerhub.com/DOKUTECHNOLOGY/Merchant-Interface/1.0.0/direct-debit/merchant/shopeepay/v1.0/debit/payment-host-to-host' \
  --header 'X-TIMESTAMP: 2020-12-21T07:56:11.000Z' \
  --header 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \
  --header 'X-PARTNER-ID: 821508239190' \
  --header 'X-EXTERNAL-ID: 418075533589' \
  --header 'X-DEVICE-ID: 95221' \
  --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ' \
  --header 'Content-Type: application/json' \
  --data '{"partnerReferenceNo":"INV_20221221_0002","validUpTo":"2022-07-20T07:00:00+07:00","amount":{"value":"12345678.00","currency":"IDR"},"urlParam":[{"url":"http://www.test.com","type":"PAY_RETURN","isDeepLink":"N"}],"additionalInfo":{"productCode":"51051000100000000001","supportDeepLinkCheckoutUrl":true,"order":{"orderTitle":"Demo"},"envInfo":{"sourcePlatform":"IPG","terminalType":"SYSTEM"}}}'

200

400

401

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

Payment successful

Refund Merchant Interface

Merchant interface for Refund Dana SNAP

post

/direct-debit/merchant/shopeepay/v1.0/debit/refund

Header parameters

X-TIMESTAMPstring · utc timestamprequired

Client's current local time in yyyy-MM- ddTHH:mm:ssTZD format

Example: 2020-12-21T07:56:11.000Z

X-SIGNATUREstringrequired

Algorithm symmetric signature HMAC_SHA512 (clientSecret, stringToSign)

Example: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5

X-PARTNER-IDstringrequired

Unique ID for a partner (DOKU'S Client ID)

Example: 821508239190

X-EXTERNAL-IDstringrequired

Numeric String. Reference number that should be unique in the same day (request-id)

Example: 418075533589

X-DEVICE-IDstringrequired

Device identification on which the API services are currently being accessed by the end user (customer). Can’t contain symbols

Example: 95221

X-IP-ADDRESSstring

conditional. IP address of the end user (customer) using IPv4 format

Example: 95221

Authorizationstringrequired

Access Token obtained from Get B2B Token API

Example:

Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ

Body

originalPartnerReferenceNostringrequired

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

Example: Testing-123

partnerRefundNostringrequired

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

Example: 20230915123232

originalExternalIdstringrequired

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

Example: 20230926103436

reasonstring

Reason of refund | max length: 256

Example: Cancel Order

refundAmountobject

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://virtserver.swaggerhub.com/DOKUTECHNOLOGY/Merchant-Interface/1.0.0/direct-debit/merchant/shopeepay/v1.0/debit/refund' \
  --header 'X-TIMESTAMP: 2020-12-21T07:56:11.000Z' \
  --header 'X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \
  --header 'X-PARTNER-ID: 821508239190' \
  --header 'X-EXTERNAL-ID: 418075533589' \
  --header 'X-DEVICE-ID: 95221' \
  --header 'Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE2OTgwNTA3NDMsImlzcyI6IkRPS1UiLCJjbGllbnRJZCI6IkJSTi0wMjExLTE2OTY5MTk2NTE5MTgifQ.x-D5VlK6TlVZbLPUSCr-Gbfgh4tnp0QDJmedYFHJGHFjg1c4x39pszU4sLvRhr0Jk0vKdMIzxUZeNhKoesWqDJitnG3kfrNZNsMb_WYUC0tJW91onXzYOKXiTgsHwRNFoWPQHlXIEtT3RQm-SRlCpk_E0gsavgkQn2-kbJEBnPhIs4eKg5IUY9GYi4hRr-_GHsudDl8sd2B5UBB_rHYq36BRmLXH7i7MQADHPsB1ktPVgk3ZWF0jebEjI-lJ88p-omL1vQNvRseXej2HKBa9chGLmPDvXYBQaRmmstHz-tv1boFrHfwsHJebcUec-i3WE1vMvP_3EPXdbqb45N4ciQ' \
  --header 'Content-Type: application/json' \
  --data '{"originalPartnerReferenceNo":"Testing-123","partnerRefundNo":"20230915123232","originalExternalId":"20230926103436","reason":"Cancel Order","refundAmount":{"value":"12345678.00","currency":"IDR"}}'

200

400

401

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

Refund successful