Contis API – Introduction

     

    Welcome to Contis. We provide end-to-end banking and payments platform.

    Consider us your Bank in a Box!

    Open a primary account with or without payment card and link it to multiple secondary accounts. Use direct debit, Envelope, standing order, P2P and transfer APIs to automate your account management for a smoother, faster and better banking experience, without going to bank.

    Our platform is securely hosted and managed so that you can focus on providing the best possible banking experience for your customers.

    We know how important it is to move swiftly, that is why we’ve created a Quick start guide for you.

    For more detail read on…

    The platform is fully owned by Contis. It is PCI DSS Level 1 compliant and independent of multiple third-party providers - BIN sponsors, card issuers and payment processors.

    Our Application Programming Interfaces (APIs) are designed to offer a high level of personalisation and control over back-end services. Giving you more time to spend on building and scaling your business instead of managing servers and databases.

    Use our APIs to create and manage consumer profiles and accounts, handle payment card production (Visa debit, prepaid and virtual cards) and set up Direct Debits and Standing Orders.

    API controllers

    Contis APIs are REST based with resource-oriented URLs and use HTTP based response codes to indicate API errors. We have grouped our APIs by function into “controllers”. Each controller contains the APIs you will need to integrate into your interface to allow your end users to access the features for a different area of the Contis service.

    Consumer

    A consumer is anyone who holds an account or payment card. Main (primary) consumers are linked to the primary account and any additional secondary accounts which may exist. Main consumers must be over the age of 18.

    The main consumer can add secondary users, such as friends and family members to the primary account. Secondary users must be over the age of 13.

    Secondary users can be assigned their own secondary account with a separate account number, a facility which can be used to apply transaction limits separate to those of the primary account.

    Consumer controller

    Within the Consumer controller, the API methods enable you to execute consumer-related functions, including:

    • Create a new consumer account or add many secondary accounts to it.
    • Get or update personal and contact information of a consumer.
    • Fetch account information like IBAN, BIC, sort code and account number.
    • View list of primary and secondary consumers linked of an account.

    Account

    A primary account can have one or more secondary sub-accounts. A secondary account usually belongs to a friend or family member. Primary and secondary accounts are both linked to a single consumer agreement.

    Account controller

    Within the Account controller you can execute account management functions through the API methods, including:

    • Get information about an account, the latest balance and load limit.
    • Change the overdraft limit and terms of an account.
    • Give an account an easily memorable nickname.
    • Get a list of a consumer’s transactions and accounts.

    Note the following Account definitions:

    • Bank account – The external bank account linked to the consumer’s account.
    • Client scheme account – The main account of the client, which is linked to multiple secondary accounts of customers of the client. The client account and sub-accounts have the same programme agreement settings.
    • Third-party account – The beneficiary account within Contis to which you (consumer) can transfer money

    Card

    Contis allows you to issue and manage debit, prepaid, and virtual payment cards. Each card issued by Contis (the Issuer) has a status. Take a note of the different statuses of the cards:

    • Active – a card in normal, working mode.
    • Inactive – a card is in inactive mode. It has to be activated before you can use it to make a payment.
    • Expired – a card has reached its expiry date. The Issuer will reissue a new, replacement card if the card has transacted in the previous 3 months.
    • Lost – a card has been stolen or lost permanently. The Issuer blocks the card to prevent its misuse and if requested, replaces it. If no request is made the issuer will cancel the card and close the account. Only Active and Inactive cards can be marked as Lost. Cards cannot be made ‘Active’ again once marked as lost
    • Closed – a cardholder's account is terminated and must open a new account to continue using your banking services.
    • Blocked – a cardholder may request that their card is blocked, for example, if it has been misplaced. If found, the Issuer revokes the block instruction and enables the use of the card. A lost or stolen card is automatically blocked.
    • Cancelled – a cancelled card is blocked with immediate effect on receipt of the cancellation request. The Issuer stops charging the card fee and will close the account.

    Card controller

    Within the card controller you will find the API methods that enable you to execute card functions, including:

    • Activate a card and token.
    • Request and configure the functionality of a new card.
    • Mark a card as damaged, lost or blocked.
    • Manage virtual cards, including adding them and viewing specific information about active virtual cards.
    • Retrieve and change the PIN.
    • Get a list of cards, tokens, and pending payments.

    Direct Debit

    The Direct Debit instruction is sent to their bank by the Payer. It authorises the Payee to collect the required amount directly from the Payer’s bank account. The Payee requests an amount to be debited from the Payer’s account on the specified date. Direct Debits are collected on the same date each month. All direct debit instructions are setup on your end users account automatically.

    Direct Debit allows:

    • Regular payments of amounts which can vary e.g. telephone bills.
    • Recurring payments towards fixed subscriptions e.g. Internet services.
    • Loan repayments

    Direct debit controller

    Within the Direct Debit controller, you can:

    • Cancel a Direct Debit instruction
    • Get list of Direct Debit payments or instructions for a specified account number.

    Envelope

    Envelopes enables your customers to set aside funds on payday for their recurring expenses later that month. The Envelopes safeguards the funds needed for essential expenses, preventing accidental over-spend and automatically pays pre-arranged amounts for important expenses like rent, utilities, and grocery bills. The payment cycle to beneficiaries from the Envelopes can be set up as weekly or monthly.

    Your customers have peace of mind that funds in their account sitting outside the Envelopes are disposable.

    Envelope controller

    Within the Envelope controller you can use API methods that enable you to execute different Envelope-related functions:

    • Reserve fund in an Envelope within an account or release back the fund from envelope into account for normal use.
    • Execute direct debit payment through an expense Envelope.
    • Get or update information about an Envelope.
    • Fetch a list of Envelopes within an account.
    • Disconnect or delete an Envelope from an account.

    Saving Envelope

    Saving Envelope is a new envelope feature for saving as much amount available in account, in the envelope. You can transfer full amount from the account or add as much amount permitted by account limits into the saving envelope. You can withdraw all the amount from saving envelope or transfer it back to the account.

    Saving Envelope controller

    Within the Saving Envelope controller, you can:

    • Add or delete a saving envelope.
    • Get transaction history of the saving envelope.
    • Transfer full amount from account to the saving account or vice versa.
    • Change name, account and target date of the saving envelope.

    KYCDigital

    The API methods in controller enable you to execute KYCDigital related functions. Get KYC Token to perform online KYC, Get KYC Status and add consumer after done with successfully KYC.

    KYCDigital controller

    Standing Order

    A Standing order is an instruction to transfer a fixed amount on a daily, weekly, monthly basis to a beneficiary account. The instruction can be set to make a fixed number of payments at specified time intervals.

    Note the following:

    • Standing orders must be set up at least 24 hours prior to the first payment. Standing order can be used to transfer funds to, other programme accounts, and UK and international banks.
    • A transfer fee is charged according to the destination of the payment.
    • Fees are not charged for money transferred to another account on the programme.
    • All standing orders are processed at 14:30 on working days from Monday to Friday.

    Standing Order controller

    Within the Standing Order C ontroller use the API methods manage your Standing Orders, including:

    • Activate or deactivate a standing order.
    • Get a list of active and inactive standing orders.
    • View execution dates for specific standing orders.
    • Cancel a standing order.

    Transfer

    Transfer defines the act of making a payment from the consumer to a recipient.

    Transfer controller

    Within the transfer controller, the APIs enable you to:

    • Execute transfer money to a recipient’s account.
    • Link an account in Contis with an external bank account and transfer funds.
    • Get a list of recipient accounts linked to a specific account in Contis.
    • Fetch the IBAN, BIC, sort code, and the name of a specific beneficiary account.
    • Upload a bulk payment file for the transfer of funds to a beneficiary account from internal, third-party or external bank accounts.

    P2P

    Person-to-person (P2P) is a money transfer between a payer and a payee. The payee makes a request for a transfer from the payer.

    P2P controller

    Within the P2P controller you can use APIs to:

    • Request or receive money.
    • Reject a money transfer request.
    • Generate a money transfer request via an account number, email or mobile number.
    • Retrieval of recipient account numbers and information.
    • Add or delete a recipient.

    Security

    To access any of our APIs a user must login using a username and password. Once a user is authenticated a token will be returned by the Contis server. This token is used to authenticate subsequent API calls. On expiry of a token, the user is automatically logged out of the system. The expiry time is set at the programme level and can be increased or decreased as required.

    Security controller

    Within the security controller, APIs enable Consumers to securely login and logout of the system.

    Consumer Security

    To access any of our APIs a user must login using a username and password. Once a user is authenticated a token will be returned by the Contis server. This token is used to authenticate subsequent API calls. On expiry of a token, the user is automatically logged out of the system. The expiry time is set at the programme level and can be increased or decreased as required.

    Consumer security controller

    Within the consumer security controller, APIs enable consumers to securely login and logout of the system.

    SSO (Single Sign On)

    Single Sign-On is a one-time authentication service that allows a user to sign-on to multiple applications with a single password and username.

    SSO (Single Sign On) controller

    Within the SSO controller, use API methods to:

    • Manage Single Sign-On session functionality.
    • Allow consumers to register for SSO service and authenticate sign in.
    • Call API to deregister from the service.

    Communication

    Communication refers to the exchange of information between a consumer and the Contis system. It can be a consumer enquiry or a notification to the user regarding a transaction, an activation, a dispute or an update on a product or service.

    Communication controller

    Within the Communication controller, you can add a reference note and generate an enquiry.

    Account Only

    The type of account without any payment cards linked to it.

    Account only controller

    Within the Account only controller, you can:

    • Link up additional consumers to the primary consumer.
    • Create a consumer with a new account and link it to a primary consumer account.
    • Create of new primary and secondary consumers and link them together.

    Junior Consumer

    Junior consumers are secondary consumers aged 13 to 17. They are linked to their guardian’s primary account or their own secondary account. Junior consumers will need to verify their date of birth, guardian’s name and relationship to the guardian during the Know Your Customer (KYC) process.

    Junior Counsumer controller

    Use the API to create a junior consumer linked to the primary consumer.

    Programme

    A Programme is a configurable template that can be customised to meet your needs and those of your consumers. You can vary agreement terms, fees, communication format, card design and currency to create customized Programme for retailers, merchants, and individual users.

    Programme controller

    Within the programme controller you can use APIs to:

    • Get a list of countries in which a bank can receive money as defined by the programme code.
    • Get the name(s) of the client(s) registered under a specific Programme.

    Business

    For the purposes of our APIs, we define a Business as any private limited company, Sole trader or partnership firm with the intent to make a profit.

    Business controller

    Within the business controller you can use APIs:

    • Activate a company set up after registration.
    • Change details of a company.
    • Get a list of transactions and balance in a company’s account.
    • Set or get card spending limits of a company’s account.
    • Get a list of companies.
    • Get a specific location or list of locations for the company

    Sole Trader

    A Sole trader is a self-employed person who runs a business as an individual. The person can own a business under their own name or any other name.

    Sole Trader controller

    The Sole Trader controller enables you to register a business in your customer’s own name.

    Partner

    In a partnership, the partners personally share responsibility for the business. Any losses a business makes, bills for the business and purchases of stock or equipment fall to the partners. Partners share the profits from the business, and each partner pays tax on their share. A partner doesn’t have to be a person. For example, a limited company can also be a partner.

    Partner controller

    Within the Partner controller you can find the APIs to:

    • Register company credentials to create a partnership firm.
    • Create a new partnership company or firm.
    • Create Primary director(s).
    • Set up an account.

    Limited Company

    In a limited company, the liability of members or subscribers of the company is limited to what they have invested or guaranteed to the company. Limited companies may be limited by shares or by guarantee.

    Limited Company controller

    The limited company controller enables you to register a limited company and set up director(s) in the Contis API system.

    Basic Company

    The term basic company identifies whether a company is a corporation, a partnership firm, private limited company or a sole proprietorship.

    Basic Company controller

    The Basic Company controller has a single method for registering companies.

    Director

    A director is a person appointed by the shareholders of the private limited company to manage day-to-day business activities. A company can have more than one director. Large companies are run by a board of directors within the framework laid down by the law.

    Director controller

    The director controller has API methods that enable you to execute director related functions in the company:

    • Add a new director
    • Get or update personal and contact information of an existing director.
    • Fetch a list of directors and know who the main or secondary directors are, including their percentage ownership in the company.

    Department

    A department is a distinct division within a company with a specialized function or output. Departments are created in a company to improve the efficiency and productivity of the business.

    Department controller

    Within the department controller, you can manage the departments linked to a company, including:

    • Add a new department.
    • Change the Head of Department (HOD).
    • Get a list of departments in the company.
    • Update the information about a department.
    • Set and view monthly, weekly or yearly ATM, POS or e-commerce limits of a specific department.

    Dual Authorisation

    Dual authorisation is a security feature that requires two or more, different authorisers to authorise a payment, if it is above the set limit. In dual authorisation, two or more people in the same business can complete a third-party payment, with one creating a payment request and one or more authorisers authorising the payment.

    Dual Authorisation controller

    Within the Dual Authorisation controller you can:

    • Approve, cancel or decline an authorisation request.
    • Get list of authorisers.
    • Get list of approved, pending or cancelled dual authorisations.
    • Set authorising limit of authorisers.

    SCA

    To access any of our APIs a user must login using a username and password. Once a user is authenticated a token will be returned by the Contis server. This token is used to authenticate subsequent API calls. On expiry of a token, the user is automatically logged out of the system. The expiry time is set at the programme level and can be increased or decreased as required.

    SCA controller

    Within the security controller, APIs enable Consumers to securely login and logout of the system.

    SCA2

    To access any of our APIs a user must login using a username and password. Once a user is authenticated a token will be returned by the Contis server. This token is used to authenticate subsequent API calls. On expiry of a token, the user is automatically logged out of the system. The expiry time is set at the programme level and can be increased or decreased as required.

    SCA2 controller

    Within the security controller, APIs enable Consumers to securely login and logout of the system.

    Was this page helpful to you?