Start here

What this sandbox is

MrIvory on this host is a local merchant backend. It speaks the eight paths listed on the overview, signs responses with the same HASH rule, and stores sales, refunds, and payouts in a JSON file. It does not talk to Visa, Mastercard, or a live acquirer.

Success rule

A sale or refund is successful only when RESPONSE_CODE is 000 and STATUS is Captured. 000 plus Enrolled means the sandbox 3DS step is still open. Payout initiate usually returns 703 / Pending — poll getStatus.

Amounts

API amounts are integer minor units with no decimal point. AED 10.00 and USD 10.00 are both 1000. JPY 10 is 10. The panel UI shows major units (AED 10.00). Payout PAYOUT_BALANCE is a decimal string such as 10000.00.

Currencies

CURRENCY_CODE is the ISO numeric code. Unknown codes return 130 (pay-in) or 326 (payout). Codes the sandbox accepts include 784 AED, 840 USD, 978 EUR, 826 GBP, 356 INR, 682 SAR, plus the other ISO numeric codes in the server currency table.

Credentials

Every signed call needs APP_ID and HASH. The seeded demo merchant APP_ID is 1000221129001154 (sandbox@mrivory.test). The secret used to build HASH is on My Profile after you sign in. Never send the secret as its own field. Use your APP_ID in production-shaped integrations — the demo id is only for this host.

What is stored

After a card is classified, PAN and CVV are dropped. The transaction keeps CARD_MASK (first 6 + last 4, middle starred) and MOP_TYPE (VI or MC for the published test cards).

Webhook

If My Profile has a Notification/Webhook URL, the sandbox POSTs a signed JSON body when a sale is captured or declined and when a refund is created. The payload uses TXNTYPE=NEWORDER and includes HASH. Recurring invoice and subscription events use an EVENT field. There is no retry schedule beyond a 5 second timeout. See Webhooks.

Helpers (not in the eight)

The hosted page posts card data to /pgui/jsp/hostedPay and the sandbox 3DS button posts to /pgui/jsp/hostedChallenge. A demo return page lives at /pgui/jsp/response.jsp. Styles and the iframe helper are at /pgui/checkoutlibrary/checkout.min.css and checkout.min.js.