These endpoints support Merchant integrations of Flexiti services.
...
For full Widget documentation start here - Flexiti Widget - Online Channel - POS API
DEPRECIATED - POST /client-id/{client_id}/merchants/login
| 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.
This endpoint needs a token with the customer scope
Request Parameters:
...
Type
...
Parameter
...
Required
...
Details
...
HEADER
...
authorization
...
Yes
...
ASCII string (1000)
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 (2)
Customer Preferred language
Available values: (en=English) or (fr=French)
Default: en
...
BODY
...
merchant_username
...
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 | ||||
|---|---|---|---|---|
| ||||
{
"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
Success Response:
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"merchant_name": "ACME Jewellers",
"merchant_id": "123456",
"form_values": {
"salutation": {
"options": {
"mr": "Mr.",
"ms": "Ms.",
"mrs": "Mrs.",
"mss": "Miss."
}
},
"province": {
"options": {
"AB": "Alberta",
"BC": "British Columbia",
"MB": "Manitoba",
"NB": "New Brunswick",
"NL": "Newfoundland & Labrador",
"NS": "Nova Scotia",
"NT": "Northwest Territories",
"NU": "Nunavut",
"ON": "Ontario",
"PE": "Prince Edward Island",
"QC": "Quebec",
"SK": "Saskatchewan",
"YT": "Yukon Territory"
}
},
"security_qid": {
"options": {
"4": "What is the name of your favourite childhood friend?",
"5": "What is the country of your ultimate dream vacation?",
"6": "What was the first concert you attended?",
"7": "What is the name of the street you grew up on?",
"8": "What is the name of your first grade teacher?",
"9": "What is your favourite movie?"
}
},
"govid_type": {
"options": {
"CADL": "Driver's Licence",
"CAHC": "Health Card",
"CAPID": "Provincial ID Card",
"CAP": "Passport",
"CAPRC": "Permanent Resident Card",
"CAICBC": "Insurance Corporation of British Columbia",
"CAAR": "Alberta Registries",
"CASGI": "Saskatchewan Government Insurance",
"CADSNS": "Department of Service Nova Scotia and Municipal Relations",
"CADPPEI": "Department of Transportation and Public Works of the Province of Prince Edward Island",
"CASNB": "Service New Brunswick",
"CADGSNF": "Department of Government Services and Lands of the Province of Newfoundland and Labrador",
"CADTNW": "Department of Transportation of the Northwest Territories",
"CADCTN": "Department of Community Government and Transportation of the Territory of Nunavut",
"CACSC": "Correctional Service Canada identification card (with the individual's name and photograph)",
"CAGCEC": "Government of Canada employee identity card (with the individual's name and photograph)",
"CALCB": "Liquor Control Board Age of Majority (BYID) card",
"CACFL": "Canadian Firearms licence",
"CACFID": "Canadian Forces identification card",
"CAMPIC": "MPIC card issued by the Manitoba Public Insurance Corporation",
"CACAID": "NEXUS or CANPASS Air membership card (issued by Canada Border Services Agency)"
}
},
"govid_issued_by": {
"option_depends": {
"CADL": {
"AB": "Alberta",
"BC": "British Columbia",
"MB": "Manitoba",
"NB": "New Brunswick",
"NL": "Newfoundland & Labrador",
"NS": "Nova Scotia",
"NT": "Northwest Territories",
"NU": "Nunavut",
"ON": "Ontario",
"PE": "Prince Edward Island",
"QC": "Quebec",
"SK": "Saskatchewan",
"YT": "Yukon Territory"
},
"CAHC": {
"BC": "British Columbia",
"NB": "New Brunswick",
"NL": "Newfoundland & Labrador",
"NT": "Northwest Territories",
"NU": "Nunavut",
"QC": "Quebec",
"SK": "Saskatchewan",
"YT": "Yukon Territory"
},
"CAPID": {
"ON": "Ontario"
},
"CAP": {
"CANADA": "Canada"
},
"CAPRC": {
"CANADA": "Canada"
},
"CAICBC": {
"BC": "British Columbia"
},
"CAAR": {
"AB": "Alberta"
},
"CASGI": {
"SK": "Saskatchewan"
},
"CADSNS": {
"NS": "Nova Scotia"
},
"CADPPEI": {
"PE": "Prince Edward Island"
},
"CASNB": {
"NB": "New Brunswick"
},
"CADGSNF": {
"NL": "Newfoundland & Labrador"
},
"CADTNW": {
"NT": "Northwest Territories"
},
"CADCTN": {
"NU": "Nunavut"
},
"CACSC": {
"CANADA": "Canada"
},
"CAGCEC": {
"CANADA": "Canada"
},
"CALCB": {
"AB": "Alberta",
"BC": "British Columbia",
"MB": "Manitoba",
"NB": "New Brunswick",
"NL": "Newfoundland & Labrador",
"NS": "Nova Scotia",
"NT": "Northwest Territories",
"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"
}
}
} |
DEPRECIATED - GET /client-id/{client_id}/merchants/information
| Code Block |
|---|
https://{posapi_url}/flexiti/pos-api/v2.5/client-id/{client_id}/merchants/information?lang=en |
Or
| Code Block |
|---|
https://{posapi_url}/flexiti/pos-api/v2.5/client-id/{client-id}/information?lang=en&message=qcpa_disclosure |
| Warning |
|---|
This endpoint has been depreciated with our 20.3 Release |
This endpoint will return HTML for information/message purposes, such as disclosures. You can retrieve all messages or filter for specific messages using a key in the URL
This endpoint needs a token with the customer scope
Request Parameters:
...
Type
...
Parameter
...
Required
...
Details
...
HEADER
...
authorization
...
Yes
...
ASCII string (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 (5)
Customer Preferred language
Available values: (en=English) or (fr=French)
Default value: en
...
QUERY
...
message
...
ASCII string (1000)
Specific values can be used to filter the response
Not passing a value will response with all messages.
Success Response:
200 - Success - All
| Code Block | ||
|---|---|---|
| ||
[
{
"qcpa_disclosure": "......."
},
{
"annual_fees": ".."
},
{
"key_3": "....."
}
] |
200 - Success - Specific Message filtered
...