General Questions
What is Slice?
Slice is an Easy Payment Plan (EPP) feature that allows eligible customers to pay for purchases in installments instead of a single upfront payment.
Which integrations support Slice?
Slice is supported across:
- Direct API
- Hosted Session
- Pay Page
- Android SDK
- iOS SDK
Does Slice require additional integration?
No.
- Hosted Session: Fully automatic
- Direct API: Requires calling the eligibility endpoint
Slice is enabled through configuration and exposed dynamically via API responses.
Eligibility & Availability
Why is Slice not showing during checkout?
Slice is displayed only when all eligibility conditions are met.
Common reasons include:
- Unsupported currency (only AED is supported)
- Transaction amount below the configured threshold
- Card is not part of the eligible BIN range
- Issuer does not support Slice
- Transaction type is not supported
Can I force Slice to be displayed?
No.
Slice availability is determined dynamically based on:
- Transaction details
- Card eligibility
- Issuer validation
If a transaction is not eligible, the payment continues as a standard card payment.
Which currencies are supported?
Currently:
- ✅ AED
All other currencies are not supported.
What transaction types support Slice?
Supported:
- Purchase
Not supported:
- Sale
- Authorization-only
- Capture
- Device payments
Payment Flow
What happens if no installment plans are returned?
- Slice is not available for the transaction
- The checkout continues using the standard payment flow
What happens if the customer does not select a plan?
- The payment is processed as a standard card transaction
Is Slice applied automatically?
No.
- The customer must explicitly select an installment plan
- Otherwise, a standard payment is processed
API & Integration Behaviour
How do I check Slice eligibility in Direct API?
Slice eligibility is exposed via a link relation in the order response:
"payment:slice-eligibility-check"Use this endpoint to:
- Validate eligibility
- Retrieve available installment plans
Should I hardcode the Slice endpoint?
No.
Always use the link returned in the API response.
Slice endpoints are dynamic and should not be constructed manually.
Are amounts in major or minor units?
All amounts must be provided in minor units.
Example:
- AED 200.00 →
20000
Reversals & Refunds
What happens when a payment is reversed?
If a transaction is reversed before settlement:
- The payment is cancelled
- The associated Slice installment plan is automatically cancelled
- The customer is no longer enrolled in the plan
Are refunds supported?
Yes.
- Refunds follow standard N-Genius Online refund processes
- Slice plans are handled accordingly by the downstream systems
Limitations
Current limitations include:
- Only AED currency is supported
- Only Purchase transactions are supported
- Slice availability depends on external issuer validation
- Not all cards are eligible
Best Practices
To ensure a smooth integration:
- ✅ Always handle fallback to standard payment
- ✅ Do not assume Slice availability
- ✅ Display plans only when returned
- ✅ Clearly show installment details to customers
- ✅ Test using provided Slice test cards
Related Guides
- Slice Overview
- Direct API Integration
- Hosted Session Integration
- Slice API Reference
- Test Cards