Full Install Checklist

This document lists the topics that merchants should be familiar with before setting up a full Flex Fields implementation (with links to the relevant extended documentation).
Splitit Sandbox Credentials
  1. 1.
    API Username: xxx
  2. 2.
    API Password: xxx
  3. 3.
    Payment Terminal API Key: xxx
Obtain here.
Key Documentation
The following steps will be integrated:
  1. 1.
    Login API call to authenticate and retrieve SessionId (valid for 20 minutes)
  2. 2.
    Initiate API call use SessionId to retrieve PublicToken (used within Flex Fields - valid for one hour)
  3. 3.
    Flex Fields front-end components (HTML, CSS, JS)
  4. 4.
    Compare client-side to server-side to ensure the data is consistent before order creation (via Flex Fields or API call):
5. Merchant order reference, if not available during Initiate request, should be updated
via separate Update API call or client-side with Flex Fields (if available):
  • Update API (mainly used for server side update if the order id is available only after the payment is done)
  • Flex Fields (mainly used if the order id is available from the client side before the payment is done but after the Flex Fields module is initiated)
On-Site Messaging
Merchant must integrate Splitit messaging throughout the customer journey which ensures consumers' awareness and maximizes conversion.
On-Site Messaging provides a simple way to add price breakdown messaging on product, cart and checkout pages.
Order Management
Order Management will be issued through the Splitit API and processed through Merchant's Gateway.
  1. 1.
    Refund API Call
  2. 2.
    Cancel API Call
  • Determine whether to automate the first installment capture or implement a separate API call to capture when the order is shipped (AutoCapture)
  • Handle SessionId or PublicToken expired scenarios (which expire after 20 mins. and 60 mins., respectively)
  • Share consumer address data either via Initiate API call or client-side with Flex Fields
The 3DS flow can be integrated as follows:
  1. 1.
    Enabled for all transactions on Splitit merchant account(s):
    • Sub account one UK/EU - 3DS enabled for all transactions
    • Sub account two ROW - 3DS disabled for all transactions
  2. 2.
    Enabled per transaction on the Initiate API call in the PlanData object: "PlanData": {"Attempt3DSecure": true}
Test Card Numbers:
  • Visa Credit Card: 4111 1111 1111 1111
  • Mastercard Debit Card: 4222 2222 2222 2220
  • Amex Credit Card: 3711 111111 11114
  • CVV: Visa/MC any 3 digits; Amex any 4 digits
  • Expiry: Any future date
Migrating Sandbox to Production
  1. 1.
    Update Flex Fields front-end components:
<script src=""></script>
2. Update API environment:
  1. 1.
    Sandbox URL:
  2. 2.
    Production URL:
Last modified 2mo ago