Test Mobile Wallets

A single sandbox mobile wallet is available per payment provider. The mobile wallet credentials are used to simulate the customer payment through prompt. The PIN is used to authorize the transaction, while the outcome of the transaction is selected in the merchant portal.

How to Simulate a Successful Push Payment

1

Log in to the merchant portal

Log in to the OneKhusa Portal using your sandbox merchant account.
2

Open Test Your Integration

Go to Test Your Integration and select Simulate Push Payment.
3

Create the simulated push

Use the Push Payment API to create the push payment. The new transaction appears in a Pending state, waiting for customer authorization.
4

Authorize the pending transaction

Open the pending transaction and select Authorize to simulate the customer approving the payment.Use the Authorization PIN provided for the test account to complete the simulated customer authorization.
5

Process the success webhook

OneKhusa dispatches the pushpayment.success event to your callback URL. Verify the webhook signature before updating your payment status.

How to Simulate a Failed Push Payment

1

Create the simulated push

Use the Push Payment API to create the push payment. The new transaction appears in a Pending state, waiting for customer authorization.
2

Choose a failure scenario

Open the pending transaction and select one of the failure scenarios available in the Simulate Push screen.
3

Process the failure webhook

OneKhusa dispatches the pushpayment.failed event to your callback URL. Do not mark the order as paid when this event is received.