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_PAYMENTwith itspaymentToken.
1. Open Checkout
Callpay() 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.
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:- 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.
- 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.
- Enter the amount and select Send money.
3. Confirm the escrow is funded
Once the transfer lands, the escrow moves toOPENED / 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 account number does not resolve in the test bank
The account number does not resolve in the test bank
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 transfer succeeded but the escrow did not open
The transfer succeeded but the escrow did not open
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.
Every test bank route returns 404
Every test bank route returns 404
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.