Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Using the  /pos-api/v2.5/client-id/{clientId}/widget/initwill render the redirection_url given by the previous init call.

Note

Note: While testing Applications in the lower environment you will not receive an SMS pin - just enter 2222 as the pin value in the widget. You will receive a dynamic pin for purchases however.

API 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

BODY

customer_identification.account_number

Yes if flow is “purchase” and vcc_number and personal_information is empty

  • number (14)

  • The Account Number of the Customer

  • This is not the FlexitiCard number (VCC) or the Customer ID

BODY

customer_identification.vcc_number

Yes if flow is “purchase” and account_number and personal_information is empty

  • ASCII string (16)

  • The FlexitiCard Number (VCC) of the Customer’s Account

BODY

customer_identification.personal_information.first_name

  • Yes if flow is “apply

  • Yes if flow is “purchase” and account_number and vcc_number is empty

  • ASCII string (80)

  • Customer First Name

BODY

customer_identification.personal_information.last_name

  • Yes if flow is “apply

  • Yes if flow is “purchase” and account_number and vcc_number is empty

  • ASCII string (130)

  • Customer Last Name

BODY

customer_identification.personal_information.dob

  • Yes if flow is “apply

  • Yes if flow is “purchase” and account_number and vcc_number is empty

  • ASCII string (10)

  • Format: YYYY-MM-DD

  • Customer Date of Birth

BODY

customer_identification.personal_information.postal_code

  • Yes if flow is “apply

  • Yes if flow is “purchase” and account_number and vcc_number is empty

  • ASCII string (10)

  • Customer Postal Code

BODY

lang

  • ASCII string

  • customer’s preferred language for localization of the widget

  • Available values: en, fr

  • Default value: en

BODY

tos_agreement

Yes if flow is “apply”

  • boolean

  • Acceptance of the Cardholder Agreement (must be true at the time of submission).

  • Default value: false

BODY

flow

Yes

  • Available values: apply, purchase

BODY

email

Yes if flow is “apply”

  • ASCII string (100)

  • Customer Email

  • This will be used for MFA

BODY

phone_number

Yes if flow is “apply”

  • number (10)

  • Customer Mobile Phone Number

  • This will be used for MFA via SMS

BODY

address_1

Yes if flow is “apply”

  • ASCII string (250)

  • Customer Address Line 1

BODY

address_2

 

  • ASCII string (100)

  • Customer Address Line 2

BODY

city

Yes if flow is “apply”

  • ASCII string (100)

  • Customer City

BODY

province

Yes if flow is “apply”

  • ASCII string (2)

  • Customer Province (2 character syntax, ex. ON for Ontario)

  • Available values: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT.

...