N-Genius Payment Lab
Instructions, every test page, and sandbox test data in one place. Log in to run checkout and follow-up actions.
How to test
- Log in before opening a checkout or follow-up page (this hub is public).
- Pick a checkout page below (start with Purchase).
- Enter amount → click Hosted Payment Page (full redirect) or Hosted Session (card form on this site).
- Pay with a sandbox card from Test data.
- You return to Complete/Cancel. Open Desk · Transactions or Status to inspect state.
- For Auth → Capture → Refund, use the follow-up pages and select the same transaction.
Portal note: If create-order returns CHANNEL_OFF / no payment methods,
enable eCom card MID + currency on instant_signup_outlet in the
sandbox portal,
then retry. Lab UI works; live sandbox charges need that channel.
Full list of unfinished APIs + fixes:
payment-cycle-gaps.md.
Quick flows
Happy path — Purchase
- Open Purchase
- Amount 10.00 → Hosted Payment Page or Hosted Session
- Card 4111111111111111 / 12/30 / 123
- Land on Complete → check Desk transaction
Auth → Capture → Refund
- Open Auth → pay with success card
- Open Capture → select AUTHORISED tx → Capture
- Open Refund → select CAPTURED tx → Refund
API / other systems
- Open Swagger at /api-docs
- Or call REST /ngenius/v1 with API Key + Secret
- See OpenAPI YAML for full paths
Test data (sandbox)
Use only these published sandbox values. Never use real cards.
Card details
- CVV: Any 3 digits (Amex 4) — e.g. 123
- Expiry: Any future month/year — e.g. 12/30
- Fraud trap: Expiry month 01 → fraud reject
- Name: Any cardholder name
- Typical amount: 10.00 (default on checkout pages)
- Currency: Use outlet default (AED/SAR/…) — must match portal MID
| PAN | Brand | Expected outcome |
|---|---|---|
4111111111111111 |
Visa | Success (default) |
5168441223630339 |
Mastercard | Success |
4663295942784758 |
Visa | Declined (05) |
2303779999000275 |
Mastercard | 3DS frictionless |
2303779999000408 |
Mastercard | 3DS challenge |
4012001037141112 |
Visa | Sandbox alternate success |
5457210001000019 |
Mastercard | Sandbox alternate |
376253059827197 |
Amex | Sandbox Amex |
Full allowlist is enforced by submit_test_card.
Official list:
N-Genius sandbox test environment.
Also: /pay/test-cards.
AANI (if channel enabled)
| Mobile | Note |
|---|---|
971500000001 |
Sandbox success path (if AANI channel on) |
971500000002 |
Alternate sandbox mobile |
1. Create a payment (checkout)
Start here. Create an order, then pay with Hosted Payment Page (redirect) or Hosted Session (card form on page).
Purchase
Auth + capture in one step — best first test
/pay/purchaseAuth
Hold funds only — capture or reverse later
/pay/authSale
Sale action (auth+capture wording)
/pay/saleVerify Card
Zero-value card check
/pay/verify3DS
Frictionless / challenge sandbox cards
/pay/3dsWallets
Apple / Google / Samsung Pay
AANI
UAE AANI mobile pay
Pay by Link
Create a shareable payment URL
/pay/pay-by-linkToken Pay
Charge a saved card token
SaaS Subscription
Recurring card order, then pay the first charge on the hosted page
/pay/subscriptionClick to Pay
Config / DPA stub only
2. Follow-up actions (pick an existing transaction)
After a successful create/pay, open these pages, select the transaction, and run the action.
Capture
Full capture of an AUTH
Partial Capture
Capture less than authorised
Refund
Full refund
Partial Refund
Refund less than captured
Reverse Auth
Release an auth hold
Void
Same-day cancel
Cancel Order
Abandon a STARTED order
Cancel Capture
Undo a capture
Cancel Refund
Undo a refund
Status
Refresh order state + raw JSON
/pay/status3. Reference & docs
Test data, API contract for other systems, and Desk records.
Test Cards page
Same sandbox PANs as below
/pay/test-cardsSwagger / API docs
OpenAPI UI for /ngenius/v1
/api-docsOpenAPI YAML
Raw contract for Postman / codegen
/ngenius/v1/openapi.yamlDesk · Transactions
Logged NGenius Transaction list
Desk · Settings
Outlet, keys, Test Connection
All page links (copy)
- https://ngenius.milestoneksa.com/pay/purchase — Purchase
- https://ngenius.milestoneksa.com/pay/auth — Auth
- https://ngenius.milestoneksa.com/pay/sale — Sale
- https://ngenius.milestoneksa.com/pay/verify — Verify Card
- https://ngenius.milestoneksa.com/pay/3ds — 3DS
- https://ngenius.milestoneksa.com/pay/wallets — Wallets
- https://ngenius.milestoneksa.com/pay/aani — AANI
- https://ngenius.milestoneksa.com/pay/pay-by-link — Pay by Link
- https://ngenius.milestoneksa.com/pay/token — Token Pay
- https://ngenius.milestoneksa.com/pay/subscription — SaaS Subscription
- https://ngenius.milestoneksa.com/pay/click-to-pay — Click to Pay
- https://ngenius.milestoneksa.com/pay/capture — Capture
- https://ngenius.milestoneksa.com/pay/partial-capture — Partial Capture
- https://ngenius.milestoneksa.com/pay/refund — Refund
- https://ngenius.milestoneksa.com/pay/partial-refund — Partial Refund
- https://ngenius.milestoneksa.com/pay/reverse — Reverse Auth
- https://ngenius.milestoneksa.com/pay/void — Void
- https://ngenius.milestoneksa.com/pay/cancel-order — Cancel Order
- https://ngenius.milestoneksa.com/pay/cancel-capture — Cancel Capture
- https://ngenius.milestoneksa.com/pay/cancel-refund — Cancel Refund
- https://ngenius.milestoneksa.com/pay/status — Status
- https://ngenius.milestoneksa.com/pay/test-cards — Test Cards page
- https://ngenius.milestoneksa.com/api-docs — Swagger / API docs
- https://ngenius.milestoneksa.com/ngenius/v1/openapi.yaml — OpenAPI YAML
- https://ngenius.milestoneksa.com/app/ngenius-transaction — Desk · Transactions
- https://ngenius.milestoneksa.com/app/ngenius-settings — Desk · Settings
- https://ngenius.milestoneksa.com/pay/complete — return URL after success
- https://ngenius.milestoneksa.com/pay/cancel — return URL after cancel