Page Comparison

Required mechanisms to authenticate a 3rd party session and trigger the integration to the API.

Table of Contents

POST /oauth/token

Code Block
https://{posapi_url}/flexiti/pos-api/v2.5/oauth/token

Please note the parameters should not be passed as These endpoints support Merchant integrations of Flexiti services.

Table of Contents

...

POST /oauth/token

Code Block
https://{posapi_url}/flexiti/pos-api/v2.5/oauth/token

Please note the parameters should not be passed as Query string, the service is expecting an application/x-www-form-url encoded payload.

...

The refresh token is used to get a new access token once when the current one has expired.is about to expire. It cannot be refreshed after it is expired

In order to use it add the refresh token (provided in the original /oauth/token call) and change the grant_type to refresh_token. More information available here: How to Implement the Refresh Token

Scope Parameter Usage (IMPORTANT)

For the token endpoint there are two possible scopes: merchant or customer.

A token with a merchant scope will be allowed for all endpointsA token with a customer scope will be allowed in all endpoints required by customer facing UI, other endpoints will considered this token invalid.

...

- When to use: for Online channel implementations during the application and authorization flows (outlined below).
A token with a merchant scope will be allowed for all endpoints
- When to use: for In-store channel implementations, or Online channel back office processes like capturing an authorization, releasing, refunding/returning, etc.

The endpoints that should be called using a customer scope should be:

POST /client-id/{client_id}/merchants/logini18nPOST
GET /client-id/{client_id}widget/init/terms-and-conditions
POST /client-id/{client_id}/customers/applydriverslicense
GET POST /client-id/{client_id}widget/terms-and-conditionsinit
POST /client-id/{client_id}/apply
POST /client-id/{client_id}/informationaccounts/{account_number}/close
POST /client-id/{client_id}/accounts/{account_number}/calculate-interest
POST /client-id/{client_id}/account/{account_number}/verify
POST /client-id/{client_id}/authorization

Request Parameters:

Type	Parameter	Required	Details
FORMDATA	client_id	Yes	ASCII string (100) This is the Client ID given in the Developer User Account section
FORMDATA	client_secret	Yes	ASCII string (100) This is the Client Secret given in the Developer User Account section
HEADER	x-reference-id	Yes	ASCII string (32) GUID Unique identifier for the flow for traceability purposes
BODY	grant_type		ASCII string This is the client's access type possible values: 'password', 'refresh_token', 'client_credentials' default value: 'client_credentials'
BODY	refresh_token		ASCII string only to be used with the grant_type: refresh_token. It should be the refresh_token attribute in the last response of this method.
BODY	scope		ASCII string Available values: ‘customer', 'merchant’ Default value: merchant

Example Request:

Code Block

language	json

{
    "client_id": "flexitidemo",
    "client_secret": "77xde15a-9d33-4c15-930a-3se4b3as33e9",
    "grant_type": "client_credentials",
    "scope": "merchant"
}

Response Parameters:

Type	Parameter	Details
BODY	access_token	Bearer token to be used in subsequent calls
BODY	expires_in	Time, in seconds, that the token will last
BODY	refresh_token	Token to be used to refresh the access_token

Success Response:

Code Block
{ "token_type": "bearer", "access_token": "2d8f373a3c2b1e61baf5a7769930ff4f0e08cdb0", "expires_in": 1200, "refresh_token": "36e0fc3d7415145f4b1d71512c459fd6eaa13aa8", "scope": "merchant" }

...

GET /client-id/{client_id}/

...

i18n

Code Block
https://{posapi_url}/flexiti/pos-api/v2.5/client-id/{client-_id}/merchants/login?lang=en

Warning
This endpoint has been depreciated as of our 20.3 Release and is no longer necessary to authenticate the Merchant.

This service will log in the Merchant session and provide back an updated version of the list of parameters based on the language variable provided. This is required within the session to ensure the Merchant has the latest version of all parameters.

...

i18n

Or

Code Block
https://{posapi_url}/flexiti/pos-api/v2.5/client-id/{client_id}/i18n/{key}

This endpoint will return information for application form values and customer facing messaging like disclaimers
You can retrieve all information or filter for specific messages using a key in the URL

Request Parameters:

Success Response:

...

breakoutMode	wide
language	json

...

Type	Parameter	Required	Details
HEADER	authorization	Yes	ASCII string (

1000

40) This is the word “Bearer” with a space and then the access_token given in oauth/token API response Default value: Bearer {insert_bearer_token_from_oauth_here/token_api}
HEADER	x-reference-id	Yes	ASCII string (32) GUID Unique identifier for the flow for traceability purposes
PATH	client_id	Yes	ASCII string (100) This is the Client ID given in the Developer User Account section
QUERY	lang		ASCII string (

2merchant_username

5)
Customer Preferred language
Available values: (en=English) or (fr=French)
Default value: en

BODY

QUERY

{key}

ASCII string

Optional information to log in a specific Sales Representative or Merchant location

BODY

merchant_password

ASCII string
Optional information to log in a specific Sales Representative or Merchant location

Example Request:

Code Block

breakoutMode	wide
language	json

{
    "merchant_username": "acmejewellers",
    "merchant_password": "dice-vanila-purse"
}

Response Parameters:

...

Type

...

Parameter

...

Details

...

BODY

...

merchant_name

...

ASCII string (130)
Name of the merchant authenticated

...

BODY

...

merchant_id

...

number (10)
ID of the merchant authenticated

...

BODY

...

form_values

...

ASCII strings
Various values used in the credit application form

(1000)
Specific values can be used to filter the response
Not passing a value will response with all messages.
Available values:
- salutation
- provinces
- security_id
- govid_type
- govid_issued_by
- occupation
- transaction_type
- plan_id
- qcpa_disclosure
- insurance
- insurance_tc
- annual_fees
- housing_type

Success Response:

Code Block

{
    "salutations": {
        "mr": "Mr.",
        "ms": "Ms.",
        "mrs": "Mrs.",
        "mss": "Miss."
    },
    "form_valuesprovinces": {
        "salutationAB": {
"Alberta",
           "optionsBC": {"British Columbia",
               "mr"MB": "Mr.Manitoba",
      
         "msNB": "Ms.New Brunswick",
        "NL": "Newfoundland & Labrador",
        "mrsNS": "Mrs.Nova Scotia",
   
            "mssNT": "Miss.Northwest Territories",
        "NU": "Nunavut",
  }         }"ON": "Ontario",
        "provincePE": {"Prince Edward   Island",
        "optionsQC": {"Quebec",
        "SK": "Saskatchewan",
        "ABYT": "Alberta",Yukon Territory"
    },
    "security_ids": {
        "BC4": "BritishWhat Columbia",is the name of your favourite childhood friend?",
         "MB5": "Manitoba",What is the country of your ultimate dream vacation?",
        "NB6": "NewWhat Brunswick",was the first concert you  attended?",
          "NL7": "NewfoundlandWhat &is Labrador",the name of the street you grew up on?",
        "NS8": "NovaWhat Scotia",is the name of your first grade teacher?",
         "NT9": "Northwest Territories",
 What is your favourite movie?"
    },
    "govid_types": {
        "NUCADL": "NunavutDriver's Licence",
        "CAHC": "Health Card",
        "ONCAPID": "OntarioProvincial ID Card",
        "CAP": "Passport",
        "PECAPRC": "PrincePermanent EdwardResident IslandCard",
                "QC"CAICBC": "Quebec",Insurance Corporation of British   Columbia",
          "SKCAAR": "SaskatchewanAlberta Registries",
        "CASGI": "Saskatchewan Government Insurance",
        "YTCADSNS": "Yukon Territory"Department of Service Nova Scotia and Municipal Relations",
        "CADPPEI": "Department of Transportation }and Public Works of the Province of Prince Edward }Island",
        "security_qidCASNB": {"Service New   Brunswick",
        "optionsCADGSNF": {"Department of Government Services and Lands of the Province of Newfoundland and Labrador",
        "4CADTNW": "WhatDepartment isof the nameTransportation of yourthe favourite childhood friend?Northwest Territories",
                "5"CADCTN": "What is the countryDepartment of Community Government and Transportation of yourthe ultimateTerritory dreamof vacation?Nunavut",
        "CACSC": "Correctional Service Canada identification    "6": "What was the first concert you attended?card (with the individual's name and photograph)",
                "7"CAGCEC": "What is the name ofGovernment of Canada employee identity card (with the streetindividual's youname grew up on?and photograph)",
        "CALCB": "Liquor Control Board Age of Majority (BYID) card"8":,
"What is the name of your first grade teacher?"CACFL",: "Canadian Firearms licence",
             "9CACFID": "WhatCanadian isForces your favourite movie?"identification card",
        "CAMPIC": "MPIC card issued }by the Manitoba Public      }Insurance Corporation",
        "govid_typeCACAID": {
  "NEXUS or CANPASS Air membership card (issued by Canada Border Services Agency)"
    },
    "optionsgovid_issued_bys": {
        "option_depends": {
            "CADL": "Driver's Licence",{
                 "CAHCAB": "Health CardAlberta",
                "CAPIDBC": "ProvincialBritish ID CardColumbia",
                "CAPMB": "PassportManitoba",
                "CAPRCNB": "PermanentNew Resident CardBrunswick",
                "CAICBCNL": "InsuranceNewfoundland Corporation of British Columbia& Labrador",
                "CAARNS": "AlbertaNova RegistriesScotia",
                "CASGINT": "SaskatchewanNorthwest Government InsuranceTerritories",
                "CADSNSNU": "DepartmentNunavut",
 of Service Nova Scotia and Municipal Relations",         "ON": "Ontario",
      "CADPPEI": "Department of Transportation and Public Works of the Province of"PE": "Prince Edward Island",
                "CASNBQC": "Service New BrunswickQuebec",
                "CADGSNFSK": "Department of Government Services and Lands of the Province of Newfoundland and LabradorSaskatchewan",
                "CADTNWYT": "DepartmentYukon ofTerritory"
Transportation of the Northwest Territories",        },
        "CADCTN": "Department of Community Government and Transportation of the Territory of Nunavut","CAHC": {
                "BC": "British Columbia",
    "CACSC": "Correctional Service Canada identification card (with the individual's name and photograph)            "NB": "New Brunswick",
                "CAGCECNL": "Government of Canada employee identity card (with the individual's name and photograph)",Newfoundland & Labrador",
                "NT": "Northwest Territories",
       "CALCB": "Liquor Control Board Age of Majority (BYID) card         "NU": "Nunavut",
                "CACFLQC": "Canadian Firearms licenceQuebec",
                "CACFIDSK": "Canadian Forces identification cardSaskatchewan",
                "CAMPICYT": "Yukon Territory"MPIC
 card issued by the Manitoba Public Insurance Corporation",    },
            "CACAIDCAPID": "NEXUS{
or CANPASS Air membership card (issued by Canada Border Services Agency)"      "ON": "Ontario"
     }       },
 },           "govid_issued_byCAP": {
             "option_depends   "CANADA": {"Canada"
            },
            "CADLCAPRC": {
                    "ABCANADA": "AlbertaCanada",
            },
       "BC": "British Columbia",   "CAICBC": {
                "MBBC": "ManitobaBritish Columbia",
            },
       "NB": "New Brunswick",   "CAAR": {
                "NLAB": "Newfoundland & LabradorAlberta",
            },
       "NS": "Nova Scotia",   "CASGI": {
                "NTSK": "NorthwestSaskatchewan"
Territories",            },
        "NU": "Nunavut",   "CADSNS": {
                "ONNS": "OntarioNova Scotia",
            },
       "PE": "Prince Edward Island",  "CADPPEI":  {
                "QCPE": "Quebec",Prince Edward Island"
            },
        "SK": "Saskatchewan",   "CASNB": {
                "YTNB": "YukonNew TerritoryBrunswick"
                },

               "CAHCCADGSNF": {
                    "BCNL": "BritishNewfoundland & ColumbiaLabrador",
            },
       "NB": "New Brunswick",   "CADTNW": {
                "NLNT": "NewfoundlandNorthwest & LabradorTerritories",
            },
       "NT": "Northwest Territories",   "CADCTN": {
                "NU": "Nunavut",
            },
        "QC": "Quebec",   "CACSC": {
                "SKCANADA": "SaskatchewanCanada",
            },
       "YT": "Yukon Territory"   "CAGCEC": {
            },    "CANADA": "Canada"
           "CAPID": {
       },
             "ONCALCB": "Ontario"{
                }"AB": "Alberta",
                "CAPBC": {"British Columbia",
                   "CANADAMB": "CanadaManitoba",
                }"NB": "New Brunswick",
                "CAPRCNL": {"Newfoundland & Labrador",
                  "CANADANS": "CanadaNova Scotia",
                } "NT": "Northwest Territories",
                "CAICBCNU": {"Nunavut",
                    "BCON": "Ontario"British,
 Columbia"               "PE":  }"Prince Edward Island",
                "CAARQC": {"Quebec",
                    "ABSK": "AlbertaSaskatchewan",
                },
"YT": "Yukon Territory"
            },
  "CASGI          "CACFL": {

                   "SKCANADA": "SaskatchewanCanada"
                },
                "CADSNSCACFID": {
                    "NSCANADA": "Nova ScotiaCanada"
                },
                "CADPPEICAMPIC": {
                    "PEMB": "Prince Edward IslandManitoba"
                },
                "CASNB"CACAID": {
                    "NBCANADA": "New BrunswickCanada"
              }
 },       }
    },
    "CADGSNFoccupation_ids": {
        "options": {
            "NLFE": "Newfoundland & Labrador"Full-time Employment",
            "PE":    }"Part-time Employment",
                "CADTNWSE": {"Self-Employed",
             "RT": "Retired",
      "NT      "ST": "Northwest TerritoriesStudent",
            "HM": "Homemaker",
  },          "DS": "Disability",
     "CADCTN": {      "SW": "Seasonal Worker",
            "NUUE": "NunavutUnemployed with income",
            "UW": "Unemployed without  }income",
                "CACSC": {"OT": "Other"
        }
    },
       "CANADA"transaction_types": "Canada"{
        "promotional_purchase": "Financed Purchase",
     },   "regular_purchase": "Revolving Purchase"
    },
      "CAGCECplan_ids": {
        "1": "90 Days Grace, Equal Payments Regular Interest",
        "CANADA2": "Canada"Equal Payments, Low Interest",
        "4": "Equal Payments, Regular  }Interest",
        "5": "Equal Payments, No Interest",
   "CALCB": {    "6": "No Interest, No Payments (S.A.C.)",
           "AB7": "Alberta"No Interest, No Payments",
              "9": "No Interest, Minimum monthly payments"
   "BC": "British Columbia" },
    "qcpa_disclosure": "...",
       "insurance": "...",
      "MBinsurance_tc": "Manitoba...",
    "annual_fees": "...",
    "housing_type": {
        "NBRent": "New BrunswickRent",
 
                  "NL"Owned": "Newfoundland & LabradorOwned",

                   "NS"Relatives": "NovaLives with ScotiaRelatives",
                    "NT"Other": "Northwest TerritoriesOther",
                    "NU": "Nunavut",
                    "ON": "Ontario",
                    "PE": "Prince Edward Island",
                    "QC": "Quebec",
                    "SK": "Saskatchewan",
                    "YT": "Yukon Territory"
                },
                "CACFL": {
                    "CANADA": "Canada"
                },
                "CACFID": {
                    "CANADA": "Canada"
                },
                "CAMPIC": {
                    "MB": "Manitoba"
                },
                "CACAID": {
                    "CANADA": "Canada"
                }
            }
        }
    },
    "occupation_id": {
        "options": {
            "FE": "Full-time Employment",
            "PE": "Part-time Employment",
            "SE": "Self-Employed",
            "RT": "Retired",
            "ST": "Student",
            "HM": "Homemaker",
            "DS": "Disability",
            "SW": "Seasonal Worker",
            "UE": "Unemployed with income",
            "UW": "Unemployed without income",
            "OT": "Other"
        }
    }
}}
}

...

Code Block
https://{posapi_url}/flexiti/pos-api/v2.5/client-id/{client_id}/widget/init

The Flexiti widget is used for the Online channel only, and is for high orchestration scenarios, such as customer verification and multiple account selection. It is a UI component that’s an entry point to the Flexiti purchase flow.

For full Widget documentation start here - Flexiti Widget - POS API Online Channel Purchase Flow

Versions Compared

Old Version 47

New Version Current

Key

POST /oauth/token

POST /oauth/token

Scope Parameter Usage (IMPORTANT)

Request Parameters:

Example Request:

Response Parameters:

Success Response:

GET /client-id/{client_id}/

i18n

Request Parameters:

Success Response:

Example Request:

Response Parameters:

Success Response:

POST /client-id/{clientId}/widget/init