Notify QRIS

To notify with QRIS, you need to hit this API through your Backend:

API Endpoint

Environment	Endpoint
HTTP Method	POST
API Sandbox	https://www.yourSandboxURL.com/yourPath/yourEndpoint
API Production	https://www.yourProductionURL.com/yourPath/yourEndpoint

Here is the sample request header, request body and response body for notify QRIS:

post

This API is used to notify partners when a transaction occurs in the DOKU V2 system. DOKU will notify partners with the URL that has been registered, and the notification will be done maximum 3 times or until the notification callback response is correct.

Query parameters

WORDSstringRequired

A unique identifier for the transaction

Example: fce4964b179b0d4ee1393613d0e1017860831fef

ACQUIRERstringRequired

The acquirer code

Example: DOKU

CUSTOMERPANstringRequired

Customer's primary account number

Example: 9360050110001187249

INVOICEstringRequired

Invoice number

Example: 10093868

TRANSACTIONIDstringRequired

Transaction ID

Example: INVtestaccount07

CONVENIENCEFEEstringRequired

Convenience fee code

Example: C00000000

TERMINALIDstringRequired

Terminal ID

Example: A01

ORIGINstringRequired

Origin of the transaction

Example: INBOUND

AMOUNTstringRequired

Transaction amount

Example: 2000.00

TXNDATEstringRequired

Transaction date and time

Example: 20241107195933

MERCHANTPANstringRequired

Merchant's primary account number

Example: 936008990000047435

REFERENCEIDstringRequired

Reference ID

Example: 17etne368279

CUSTOMERNAMEstringRequired

Customer's name

Example: YURI PRAMANA

TXNSTATUSstringRequired

Transaction status

Example: S

ISSUERNAMEstringRequired

Issuer name

Example: QRIS BCAD

ISSUERIDstringRequired

Issuer ID

Example: 9360050110001187249

Body

application/json

transactionIdstring · max: 16RequiredExample: DK0018353

activityCodestringRequired

Specific notification code

Example: 200

messagestringRequired

Notification message “Transaction is Success” or “Transaction is Failed”

Example: Transaction is Refunded

processDatestringRequired

Update time in yyyy-MM-ddTHH:mm:ss format

Example: 2024-01-12'T'07:30:12

Responses

200

Notification processed Successfully

application/json

ResponsestringExample: CONTINUE

post

/{merchantUrlDirectNotification}

HTTPcURLJavaScriptPython

POST /{merchantUrlDirectNotification}?WORDS=fce4964b179b0d4ee1393613d0e1017860831fef&ACQUIRER=DOKU&CUSTOMERPAN=9360050110001187249&INVOICE=10093868&TRANSACTIONID=INVtestaccount07&CONVENIENCEFEE=C00000000&TERMINALID=A01&ORIGIN=INBOUND&AMOUNT=2000.00&TXNDATE=20241107195933&MERCHANTPAN=936008990000047435&REFERENCEID=17etne368279&CUSTOMERNAME=YURI+PRAMANA&TXNSTATUS=S&ISSUERNAME=QRIS+BCAD&ISSUERID=9360050110001187249 HTTP/1.1
Host: {merchant-domain}
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "transactionId": "DK0018353",
  "activityCode": "200",
  "message": "Transaction is Refunded",
  "processDate": "2024-01-12'T'07:30:12"
}

200

Notification processed Successfully

CONTINUE