Slice API Reference

Slice capabilities are exposed dynamically via the N-Genius Online order response using link relations.

How It Works

When a payment order is created, the response may include a Slice eligibility endpoint.

{
  "_embedded": {
    "payment": [
      {
        "_links": {
          "payment:slice-eligibility-check": {
            "href": "https://api-gateway/.../slice/eligibility-check"
          }
        }
      }
    ]
  }
}

💡

Key Insight
The payment:slice-eligibility-check link is returned only when the transaction is potentially eligible for Slice.
Use this endpoint to retrieve installment plans.

Check Slice Eligibility

Retrieves available installment plans for a transaction.

Endpoint

POST {payment:slice-eligibility-check}

Headers

Authorization: Bearer {accessToken}
Content-Type: application/json

Request

{
  "orderReference": "ORDER-12345",
  "amount": {
    "currencyCode": "AED",
    "value": 50000
  }
}

Parameters

Response

{
  "eligible": true,
  "plans": [
    {
      "tenure": 3,
      "monthlyAmount": 16666
    },
    {
      "tenure": 6,
      "monthlyAmount": 8333
    }
  ]
}

Response Fields

Behaviour

Eligible Transaction

When eligible = true:

• One or more installment plans are returned
• The merchant should display these options to the customer

Ineligible Transaction

When eligible = false or the endpoint is not returned:

• No installment plans are available
• The merchant should continue with the standard payment flow

Integration Notes

• Slice eligibility is validated in real time based on:

  • Transaction amount
  • Currency
  • Card BIN
  • Issuer validation

• The eligibility endpoint is dynamic:

  • It is returned only when applicable
  • It should not be hardcoded

• All amounts are represented in minor units

Error Handling

Common scenarios include:

✅

In all failure scenarios, continue with the standard payment flow.

Example Integration Flow

1. Create payment order
2. Check for payment:slice-eligibility-check link
3. Call eligibility endpoint
4. Display available plans (if eligible)
5. Submit payment with selected plan

Related Guides

• Direct API Integration
• Hosted Session Integration
• Slice Overview
• Test Cards