Payment Method Properties

🚧

Warning

The cent subunit is no longer used. Set the cent amount to 00 for all the IDR transactions.

Transaction Flow

Cash Payments

1. The consumer checks out on the merchant's webpage.
2. You send a transaction request to PPRO.
3. PPRO sends you a redirect URL.
4. The merchant forwards the redirect URL to the consumer’s browser.
5. The consumer selects the convenience store payment channel, and requests a payment code from their preferred convenience store.
6. DOKU shows the generated payment code to the consumer.
7. The consumer pays in the convenience store. The store notifies DOKU of the payment result.
8. DOKU notifies PPRO of the result.
9. PPRO responds to the notification.
10. PPRO sends you a transaction response.

📘

Tip

If the merchant does not receive a notify status from DOKU, run the Check Status function.

Alfamart Integration

Specific input parameters for the TRANSACTION call

*Required only if the value of specin.isflight is yes.

For standard input parameters, check Input parameters for the TRANSACTION call.

TRANSIENTIN parameters

To find out more about transient input parameters, see also this section.

transientin.orderItems format

The format per item is a serialized JSON array containing item objects.

Make sure you follow this format. Allowed characters: alphanumeric, blank space, a hyphen, underscore, and dot.

Each item contains the following fields:

Make sure that the totalcost equals the transaction amount.

🚧

Warning

If the format or the total cost of all the items is incorrect, the order details will not show on DOKU's payment page.

Example: [{"name":"table","price":"1000.00","quantity":2,"totalcost":"2000.00"},{"name":"Latop 2.0","price":"15000.00","quantity":2,"totalcost":"30000.00"}]

In the above example, there are two items in the basket.

• Item 1
  • Description: table
  • Unit price: 1000.00
  • Qty: 2
  • Total cost: 2000.00
• Item 2
  • Description: Laptop 2.0
  • Unit price: 15000.00
  • Qty: 2
  • Total cost: 30000.00

The total transaction amount must be 32000.

Specific output parameters for the TRANSACTION call

For standard output parameters, check Output parameters for the TRANSACTION call.

TRANSACTION call input

tag=doku
&txtype=TRANSACTION
&countrycode=ID
&currency=IDR
&amount=3200000
&merchanttxid=MYp3MF6zHDQm
&login=johndoe
&password=5hfGDdsfF53G
&contractid=JOHNDOETESTCONTRACT
&channel=testchannel
&merchantredirecturl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Flanding.php
&notificationurl=https%3A%2F%2Fmerchant.com%2Fwork%2Fppro2%2Fnotification.php
&accountholdername=Tester%20Doe
&specin.paymentchannel=35
&specin.bookingcode=245WJ
&specin.email=test%40test.com
&specin.ffnumber=134134
&specin.flight=01
&specin.flightdate=20191231
&specin.flightnumber=SQ321
&specin.flighttime=060000
&specin.flighttype=1
&specin.fuelsurcharge=1000.00
&specin.insurance=1000.00
&specin.isflight=no
&specin.mobilephone=628123456
&specin.passengername=Mary
&specin.passengertype=A
&specin.route=SIN-HYD
&specin.shippingaddress=Sudirman
&specin.shippingcity=Jakarta
&specin.shippingcountry=ID
&specin.shippingzipcode=12190
&specin.thirdpartystatus=0
&specin.vat=10000.00
&transientin.orderitems=[{"name":"Item.1","price":"1000.00","quantity":2,"totalcost":"2000.00"}
,{"name":"Item-2 description"","price":"15000.00","quantity":2,"totalcost":"30000.00"}]
&returnmode=urlencodeext

TRANSACTION call output

REQUESTSTATUS=SUCCEEDED
&STATUS=SUCCEEDED
&TXID=600520459
&ERRMSG=
&CHANNEL=testchannel
&TAG=doku
&REDIRECTSECRET=d6rSVahlxK0t0Du8tpD12VRE3PosHBUA
&SPECOUT.PAYMENTCHANNEL=35

Additional information

About the item format

Follow the item format strictly. Only the following character types are allowed in the item description:

• alphanumeric
• space
• hyphen
• underscore
• dot

Make sure that the total cost of all items equals the transaction amount.

If the format or the total cost of all items is incorrect, the order details will not show on the payment page.

Payment page integration options

There are two integration options:

1. Using the DOKU-hosted payment selection page
2. Redirecting straight to the specific payment method on the DOKU page

👍

Note

For both options, you have the possibility to replace the DOKU logo with the merchant logo.

Using the DOKU-hosted payment selection page

If you don't provide a value for specin.paymentchannel, the consumer is redirected to a payment method selection page with all the merchant's supported payment methods.

The following options are available:

• DOKU e-wallet (DOKU e-wallet)
• Bank transfer (Indonesian Online Banking Transfer)
• Convenience store (Alfamart, Indomaret)
• Wallet (OVO, LinkAja, Jenius Pay)
• Buy now, pay later (Kredivo)

Redirecting to the specific payment method on the DOKU page

To enable this option, make sure you populate the specin.paymentchannel item with the value that corresponds to the payment method. This option allows you to bypass the payment method selection. The consumer is redirected to the DOKU-hosted page of the specific payment method.