DuitNow Drop-in integration

Add DuitNow to an existing Drop-in integration.

This page explains how to add DuitNow to your existing Web Drop-in integration.

Requirements

Select the server-side flow that your integration uses:

Import resources for v6

If you are using Web Drop-in v6, import the resources you need for DuitNow:

import { AdyenCheckout, DuitNow} from '@adyen/adyen-web'

API reference

You do not need to send additional fields for DuitNow. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:

/sessions: This is the default with Drop-in v5.0.0 or later.
/payments: If you implemented an additional use case.

Drop-in configuration

There are no configuration steps specific to DuitNow required for Drop-in.

Test and go live

You can test your DuitNow integration in two ways: with the Adyen Payment Simulator, or directly with DuitNow.

Test with Adyen

Use the Adyen Payment Simulator to verify that your DuitNow integration works correctly with Adyen. You can test during development, before you go live, and after launch. The simulator does not recreate the shopper's journey through the DuitNow app or website.

This testing option is available by default when you add DuitNow in your test Customer Area. The payment method type is duitnow.

To test a QR code payment:

Start a payment as usual in your integration. Your integration shows a QR code.
Scan the QR code as the shopper, then select the payment outcome that you want to test on the Adyen-hosted simulator page.
Wait for the webhook message with the final payment outcome. There is no shopper redirect and no /payments/details request. If you use Drop-in, it refreshes automatically with the outcome that you selected.
Confirm that your integration handles the outcome, and that the payment appears in your Customer Area > Payments > Payment list.

Test directly with DuitNow

You can also test DuitNow payments directly with real payment details and small amounts.

Check the status of direct DuitNow test payments in your Customer Area > Payments > Payment list.

To accept live DuitNow payments, you must contact our Support Team to add DuitNow in your live Customer Area.