These endpoints are other (previous) versions of the existing Flexiti POS API, that are still active and supported, but no longer recommended for new implementations.
POST /client-id/{client_id}/accounts/{account_number}/calculate-interest
https://{posapi_url}/flexiti/pos-api/v2.5/client-id/{client_id}/accounts/12345/calculate-interest
Deprecated as of Release R21.10.0, September 22nd, 2021.
This endpoint retrieves the plan and term configured for the merchant that can be offered to a customer.
Request Parameters:
Type | Parameter | Required | Details |
---|---|---|---|
HEADER | authorization | Yes |
|
HEADER | x-reference-id | Yes |
|
PATH | client_id | Yes |
|
PATH | account_number | Yes |
|
QUERY | lang |
| |
BODY | amount |
|
Example Request:
{ "amount": 234.45 }
Response Parameters:
Type | Parameter | Details |
---|---|---|
BODY | account_number |
|
BODY | account_type |
|
BODY | amount |
|
BODY | customer.available_credit |
|
BODY | customer.air |
|
BODY | customer.first_name |
|
BODY | customer.last_name |
|
BODY | customer.customer_category_type |
|
BODY | regular_purchase.term_amount |
|
BODY | regular_purchase.air |
|
BODY | regular_purchase.verify |
|
BODY | regular_purchase.fees.description |
|
BODY | regular_purchase.fees.amount |
|
BODY | regular_purchase.fees.type |
|
BODY | regular_purchase.fees.message |
|
BODY | promotional_purchase.plan_id |
|
BODY | promotional_purchase.terms.term |
|
BODY | promotional_purchase.terms.term_amount |
|
BODY | promotional_purchase.terms.apr |
|
BODY | promotional_purchase.terms.fees.description |
|
BODY | promotional_purchase.terms.fees.amount |
|
BODY | promotional_purchase.terms.fees.type |
|
BODY | promotional_purchase.terms.fees.message |
|
Success Response - ROC Customer:
{ "account_number": 11223344, "account_type:" "consumer", "amount": 250, "customer": { "air": 0.289, "available_credit": 8000, "first_name": "John", "last_name": "Smith", "category_type": "preferred" }, "regular_purchase": { "term_amount": 250, "air": 0.289, "fees": [] }, "promotional_purchase": [ { "plan_id": 4, "terms": [ { "term": 3, "term_amount": 20.33, "apr": 0.0999, "fees": [ { "description": "Administrative fees:", "amount": 49.99, "type": "admin_total", "message": "Although your administrative fee may be represented as a monthly or annual amount, the fee is due in full if the account is paid off early. See terms and conditions for full details." } ] } ] }, { "plan_id": 5, "terms": [ { "term": 6, "term_amount": 4.67, "apr": 0, "fees": [ { "description": "Administrative fees:", "amount": 3, "type": "admin_monthly", "message": "Although your administrative fee may be represented as a monthly or annual amount, the fee is due in full if the account is paid off early. See terms and conditions for full details." } ] }, { "term": 12, "term_amount": 3.83, "apr": 0, "fees": [ { "description": "Administrative fees:", "amount": 3, "type": "admin_monthly", "message": "Although your administrative fee may be represented as a monthly or annual amount, the fee is due in full if the account is paid off early. See terms and conditions for full details." } ] } ] } ] }
Success Response - Quebec Customer
{ "account_number": 11223344, "amount": 250, "customer": { "air": 0.3124, "available_credit": 1700, "first_name": "Jacques", "last_name": "Smith", "category_type": "premium" }, "regular_purchase": { "term_amount": 250, "air": 0.3124, "fees": [] }, "promotional_purchase": [ { "plan_id": 5, "terms": [ { "term": 6, "term_amount": 41.67, "apr": 0, "fees": [] }, { "term": 12, "term_amount": 20.83, "apr": 0, "fees": [] } ] }, { "plan_id": 9, "terms": [ { "term": 6, "term_amount": 250, "apr": 0.35, "fees": [] }, { "term": 12, "term_amount": 250, "apr": 0.35, "fees": [] } ] } ] }
POST /client-id/{client-id}/authorization
https://{posapi_url}/flexiti/pos-api/v2.5/client-id/{client_id}/authorization
Deprecated as of Release R21.10.0, September 22nd, 2021.
This endpoint to creates a credit authorization for a customer from a specific Merchant.
Credit authorizations could be for:
promotional purchases
regular purchase
Request Parameters:
Type | Parameter | Required | Details |
---|---|---|---|
HEADER | authorization | Yes |
|
HEADER | x-reference-id | Yes |
|
PATH | client_id | Yes |
|
QUERY | lang |
| |
BODY | account_number | Yes |
|
BODY | vcc_number |
|
|
BODY | reference | No |
|
BODY | financing_option.transaction_type | Yes |
|
BODY | financing_option.plan_id | Yes for transaction_type = promotional_purchase |
|
BODY | financing_option.term |
|
|
BODY | amount |
|
|
BODY | auto_capture | Yes |
|
BODY | verification_code | Yes for in-store POS integrations. Not to be passed for Online implementations using the Widget |
|
BODY | sku_data.purchase_order | No |
|
BODY | sku_data.register_id | No |
|
BODY | sku_data.transaction_discount_total | No |
|
BODY | sku_data.transaction_subtotal | No |
|
BODY | sku_data.gst_hst | No |
|
BODY | sku_data.pst | No |
|
BODY | sku_data.transaction_total | No |
|
BODY | sku_data.products.sku_id | No |
|
BODY | sku_data.products.category | No |
|
BODY | sku_data.products.description | No |
|
BODY | sku_data.products.quantity | No |
|
BODY | sku_data.products.unit_price | No |
|
BODY | sku_data.products.extended_price | No |
|
BODY | billing_information.first_name | Yes if Online Channel |
|
BODY | billing_information.last_name | Yes if Online Channel |
|
BODY | billing_information.address_1 | Yes if Online Channel |
|
BODY | billing_information.address_2 | Yes if Online Channel |
|
BODY | billing_information.city | Yes if Online Channel |
|
BODY | billing_information.province | Yes if Online Channel |
|
BODY | billing_information.postal_code | Yes if Online Channel |
|
BODY | shipping_information.first_name | Yes if Online Channel |
|
BODY | shipping_information.last_name | Yes if Online Channel |
|
BODY | shipping_information.address_1 | Yes if Online Channel |
|
BODY | shipping_information.address_2 | Yes if Online Channel |
|
BODY | shipping_information.city | Yes if Online Channel |
|
BODY | shipping_information.province | Yes if Online Channel |
|
BODY | shipping_information.postal_code | Yes if Online Channel |
|
BODY | widget_session_id | Yes if Online Channel |
|
BODY | request_id | Yes for in-store channel |
|
BODY | external_location_id | Yes for In-store channel |
|
BODY | external_employee_id | Yes for In-store channel |
|
Example Request - Auto Capture with SKU items:
{ "vcc_number": "1234567890123456", "account_number": 1234567, "reference": "orderid-12345", "widget_session_id": "12345678901234567890", //if Online channel "request_id": "12345678901234567890", //if in-store channel "external_location_id" : "00-12345", //if in-store channel "external_employee_id" :"12345-SMITH" //if in-store channel "financing_option": { "transaction_type": "promotional_purchase", "plan_id": 5, "term": 6 }, "amount": 5000.12, "auto_capture": true, "verification_code": 9999, "billing_information": { "first_name": "John", "last_name": "Smith", "address_1": "1234 Main Street", "address_2": "", "city": "Toronto", "postal_code": "M1M1M1", "country": "CA", "province": "ON" }, "shipping_information": { "first_name": "John", "last_name": "Smith", "address_1": "1234 Main Street", "address_2": "", "city": "Toronto", "postal_code": "M1M1M1", "country": "CA", "province": "ON" }, "sku_data":{ { "purchase_order": "100001234", "register_id": "1A45", "transaction_discount_total": -125.08, "transaction_subtotal": 821.17, "transaction_total": 1026.47, "gst_hst": 133.45, "pst": 71.85, "products":[ { "sku_id": "100xx4567", "category": "electronics", "description": "Apple Macbook 16-inch", "quantity": 1, "unit_price": 1000, "extended_price": 984.35 }, { "sku_id": "20bb3457", "category": "office supplies", "description": "24lb Multiuse Paper, White", "quantity": 1, "unit_price": 33.99, "extended_price": 42.12 } ] }
Response Parameters:
Type | Parameter | Details |
---|---|---|
BODY | authorization_id |
|
BODY | reference |
|
BODY | date |
|
BODY | expiration_date |
|
BODY | ending_date |
|
BODY | status |
|
BODY | auto_capture |
|
BODY | amount |
|
BODY | apr |
|
BODY | message |
|
BODY | username |
|
BODY | financing_option.transaction_type |
|
BODY | financing_option.plan_id |
|
BODY | financing_option.term |
|
BODY | fees.type |
|
BODY | fees.description |
|
BODY | fees.amount |
|
BODY | fees.message |
|
BODY | merchant_information.corporation_id |
|
BODY | merchant_information.corporation_name |
|
BODY | merchant_information.merchant_id |
|
BODY | merchant_information.merchant_name |
|
BODY | merchant_information.location_id |
|
BODY | merchant_information.location_name |
|
BODY | customer.air |
|
BODY | customer.available_credit |
|
BODY | customer.first_name |
|
BODY | customer.last_name |
|
BODY | customer.category_type |
|
BODY | capture.capture_id |
|
BODY | capture.reference |
|
BODY | capture.date |
|
BODY | capture.status |
|
BODY | capture.term_amount |
|
BODY | capture.amount |
|
BODY | billing_information.first_name |
|
BODY | billing_information.last_name |
|
BODY | billing_information.address_1 |
|
BODY | billing_information.address_2 |
|
BODY | billing_information.city |
|
BODY | billing_information.province |
|
BODY | billing_information.postal_code |
|
BODY | shipping_information.first_name |
|
BODY | shipping_information.last_name |
|
BODY | shipping_information.address_1 |
|
BODY | shipping_information.address_2 |
|
BODY | shipping_information.city |
|
BODY | shipping_information.province |
|
BODY | shipping_information.postal_code |
|
BODY | account_avs.billing_information.first_name |
|
BODY | account_avs.billing_information.last_name |
|
BODY | account_avs.billing_information.address_1 |
|
BODY | account_avs.billing_information.address_2 |
|
BODY | account_avs.billing_information.city |
|
BODY | account_avs.billing_information.province |
|
BODY | account_avs.billing_information.postal_code |
|
BODY | account_avs.shipping_information.first_name |
|
BODY | account_avs.shipping_information.last_name |
|
BODY | account_avs.shipping_information.address_1 |
|
BODY | account_avs.shipping_information.address_2 |
|
BODY | account_avs.shipping_information.city |
|
BODY | account_avs.shipping_information.province |
|
BODY | account_avs.shipping_information.postal_code |
|
BODY | account_avs.business_billing_information.first_name |
|
BODY | account_avs.business_billing_information.last_name |
|
BODY | account_avs.business_billing_information.address_1 |
|
BODY | account_avs.business_billing_information.address_2 |
|
BODY | account_avs.business_billing_information.city |
|
BODY | account_avs.business_billing_information.province |
|
BODY | account_avs.business_billing_information.postal_code |
|
BODY | account_avs.business_shipping_information.first_name |
|
BODY | account_avs.business_shipping_information.last_name |
|
BODY | account_avs.business_shipping_information.address_1 |
|
BODY | account_avs.business_shipping_information.address_2 |
|
BODY | account_avs.business_shipping_information.city |
|
BODY | account_avs.business_shipping_information.province |
|
BODY | account_avs.business_shipping_information.postal_code |
|
Success Response - ROC Consumer Account:
{ "authorization_id": 12345768, "reference": "orderid-12345", "date": "2019-07-20T00:39:57Z", "expiration_date": "2019-07-20T00:39:57Z", "ending_date": null, "status": "closed", "auto_capture": true, "amount": 123.12, "apr": 0.1999, "message": "lorem ipsum", "username": "jjones", "financing_option": { "transaction_type": "promotional_purchase", "plan_id": 5, "term": 6 }, "fees": [ { "type": "admin_total", "description": "Admin fee:", "amount": 49.99, "message": "lorem ipsum" } ], "merchant_information": { "corporation_id": 1234, "corporation_name": "ACME Corporation", "merchant_id": 10028, "merchant_name": "ACME Jewellers", "location_id": 1328, "location_name": "ACME Jewellers 123" }, "customer": { "air": 0.3724, "available_credit": 2000.12, "first_name": "John", "last_name": "Smith", "category_type": "preferred" }, "capture": { "capture_id": 1234112, "reference": "orderid-12345", "date": "2019-07-20T00:39:57Z", "status": "pending", "term_amount": 123, "amount": 123.12 }, "billing_information": { "first_name": "John", "last_name": "Smith", "address_1": "1234 Main Street", "address_2": "", "city": "Toronto", "postal_code": "M1M1M1", "province": "ON" }, "shipping_information": { "first_name": "John", "last_name": "Smart", "address_1": "800 Main Ave", "address_2": "", "city": "Toronto", "postal_code": "M1M1M2", "province": "ON" }, "account_avs": { "shipping_information": { "first_name": 1, "last_name": 0.85, "address_1": 0.54, "address_2": 0, "city": 1, "postal_code": 0.92, "province": 1 }, "billing_information": { "first_name": 1, "last_name": 1, "address_1": 1, "address_2": 0, "city": 1, "postal_code": 1, "province": 1 } } }
Success Response - QC Consumer Account:
{ "authorization_id": 12345768, "reference": "orderid-12345", "date": "2019-07-20T00:39:57Z", "expiration_date": "2019-07-20T00:39:57Z", "ending_date": null, "status": "closed", "auto_capture": true, "amount": 123.12, "apr": 0.1999, "message": "lorem ipsum", "username": "jjones", "financing_option": { "transaction_type": "promotional_purchase", "plan_id": 5, "term": 6 }, "fees": [], "merchant_information": { "corporation_id": 1234, "corporation_name": "ACME Corporation", "merchant_id": 10028, "merchant_name": "ACME Jewellers", "location_id": 1328, "location_name": "ACME Jewellers 123" }, "customer": { "air": 0.3724, "available_credit": 2000.12, "first_name": "Jaques", "last_name": "Smith", "category_type": "preferred" }, "capture": { "capture_id": 1234112, "reference": "orderid-12345", "date": "2019-07-20T00:39:57Z", "status": "pending", "term_amount": 123, "amount": 123.12 }, "billing_information": { "first_name": "Jaques", "last_name": "Smith", "address_1": "1234 Main Street", "address_2": "", "city": "Montreal", "postal_code": "H1H1A1", "province": "QC" }, "shipping_information": { "first_name": "Jaques", "last_name": "Doe", "address_1": "800 Main Ave", "address_2": "", "city": "Toronto", "postal_code": "H1H1A1", "province": "QC" }, "account_avs": { "shipping_information": { "first_name": 1, "last_name": 0, "address_1": 0.54, "address_2": 0, "city": 0, "postal_code": 1, "province": 1 }, "billing_information": { "first_name": 1, "last_name": 1, "address_1": 1, "address_2": 0, "city": 1, "postal_code": 1, "province": 1 } } }
Success - ROC Business Account
{ "authorization_id": 12345768, "reference": "orderid-12345", "date": "2019-07-20T00:39:57Z", "expiration_date": "2019-07-20T00:39:57Z", "ending_date": null, "status": "closed", "auto_capture": true, "amount": 123.12, "apr": 0.1999, "message": "lorem ipsum", "username": "jjones", "financing_option": { "transaction_type": "promotional_purchase", "plan_id": 5, "term": 6 }, "fees": [ { "type": "admin_total", "description": "Admin fee:", "amount": 49.99, "message": "lorem ipsum" } ], "merchant_information": { "corporation_id": 1234, "corporation_name": "ACME Corporation", "merchant_id": 10028, "merchant_name": "ACME Jewellers", "location_id": 1328, "location_name": "ACME Jewellers 123" }, "customer": { "air": 0.3724, "available_credit": 2000.12, "first_name": "John", "last_name": "Smith", "category_type": "preferred" }, "capture": { "capture_id": 1234112, "reference": "orderid-12345", "date": "2019-07-20T00:39:57Z", "status": "pending", "term_amount": 123, "amount": 123.12 }, "billing_information": { "first_name": "John", "last_name": "Smith", "address_1": "1234 Main Street", "address_2": "", "city": "Toronto", "postal_code": "M1M1M1", "province": "ON" }, "shipping_information": { "first_name": "John", "last_name": "Smart", "address_1": "800 Main Ave", "address_2": "", "city": "Toronto", "postal_code": "M1M1M2", "province": "ON" }, "account_avs": { "shipping_information": { "first_name": 1, "last_name": 0.85, "address_1": 0.54, "address_2": 0, "city": 1, "postal_code": 0.92, "province": 1 }, "billing_information": { "first_name": 1, "last_name": 1, "address_1": 1, "address_2": 0, "city": 1, "postal_code": 1, "province": 1 } "business_shipping_information": { "first_name": 1, "last_name": 0.85, "address_1": 0.54, "address_2": 0, "city": 1, "postal_code": 0.92, "province": 1 }, "business_billing_information": { "first_name": 1, "last_name": 1, "address_1": 1, "address_2": 0, "city": 1, "postal_code": 1, "province": 1 } } }