Skip to main content
Checkout generates a temporary virtual account for every escrow payment. On staging that account is issued by a sandbox bank that has no way to send money into it, so you can open a checkout and never finish paying it. The Payluk Test Bank closes that gap. It is a simulated bank that issues the account and gives you a funded float to pay it from. Paying an account drives the same settlement your live traffic runs: the same webhook and the same verification.
The test bank exists only on staging. On production, accounts are issued by the real bank and every one of the routes below returns 404.
All money comes in as an escrow payment through the Checkout SDK. Payluk has no direct deposits and no card payments, and POST /v1/payment/virtual-account returns 410.

Before you start

You need:
  • A sk_test_ secret key and a publishable key from your Payluk dashboard.
  • A merchant customer whose country is Nigeria, and an escrow in AWAITING_PAYMENT with its paymentToken.

1. Open Checkout

Call pay() from the Checkout SDK with the escrow’s paymentToken. On staging the checkout window shows a test bank account and a Pay from Payluk Test Bank button.
A simulated account is easy to spot: the bank reads Payluk Test Bank, and the account number always begins with 99. The account is valid for 24 hours.

2. Pay the account from the test bank

Select Pay from Payluk Test Bank in the checkout window. It opens the bank with the account and amount already filled in. The window settles and closes on its own once the transfer lands. To pay by hand, open the test bank in a browser:
The test bank is served by the checkout host (staging.live.payluk.ng), not by the merchant API host (staging.api.payluk.ng). Requesting it from the API host returns 404.
Then:
  1. Pick a source account under From. Three are provided, funded with ₦1,000,000, ₦250,000, and ₦100. The last one is there so you can test an insufficient-funds rejection.
  2. Paste the account number from the checkout window into To account number. The name resolves under the field once it matches an issued account, and the amount the account expects appears beneath Amount.
  3. Enter the amount and select Send money.
The receipt names the session id and confirms that the credit notification was delivered.
Drained a source account? Select Reset balances to restore the float.

3. Confirm the escrow is funded

Once the transfer lands, the escrow moves to OPENED / ONGOING and you receive payment.escrow.success and escrow.ongoing webhooks. You can also read it back with Verify payment token or Get payment history.

What is and is not simulated

Simulated on staging

Virtual account issuance, the inbound transfer, the credit notification, and the escrow settlement that follows.

Not simulated

Payouts, bank lists, and account name enquiry against real banks. Those still run against the provider’s sandbox.

Troubleshooting

The test bank only knows accounts it issued. Check that the bank in the checkout window reads Payluk Test Bank and that the number begins with 99. An account issued more than 24 hours ago has expired: open Checkout again for a new one.
The receipt reports whether the credit notification was delivered. If it reports a failure, the money moved inside the test bank but the notification did not reach Payluk. Retry the transfer, and if it keeps failing, send the session id from the receipt to your Payluk contact.
You are either on production, where the test bank does not exist, or you are calling the merchant API host rather than the checkout host. Use https://staging.live.payluk.ng.