1.0
Create a Developer Account
Search
⌃K
Links

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
​Quick Start​
​SDKs​
Checkout
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.
​Refund guide​
  1. 1.
    ​Refund API Call
  2. 2.
    ​Cancel API Call
Miscellaneous
  • 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
3DS
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}
Testing
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="https://flexfields.production.splitit.com/v2.0/splitit.flex-fields.sdk.js"></script>
2. Update API environment:
  1. 1.
    Sandbox URL: https://webapi.sandbox.splitit.com
  2. 2.
    Production URL: https://webapi.splitit.com
Last modified 2mo ago