Welcome to Ordo Developer Portal
This portal is intended for developers who want to integrate with our APIs to interact with the Ordo platform for actions like sending smart requests and obtaining their Ordo payment information.
Our APIs rely on the RESTful best practices and they follow a resource based URL form. They make the most out of the HTTP protocol by using its verbs, response codes, and authentication. All APIs request and respond using the JSON format. For that reason you need to specify the header in your request.
Our Sign Up Process
In order to integrate with the APIs on the Ordo platform the following steps are required:
Use Sign Up to set yourself up as a User. This will generate an account confirmation email containing a link to activate the account.
After clicking the link an email will be sent welcoming you to Ordo and confirming your username/email address.
Having signed up you will then be able to subscribe to individual products. Navigate to a product, choose a name as an identifier and use the button to subscribe.
This will generate an email acknowledging your subscription and letting you know that your request will be reviewed by the Ordo team. You will then receive an email letting you know whether your subscription has been activated or whether your request has been declined.
Your subscription will provide you with a subscription key which must be used when calling the platform APIs for that product.
To access our sandbox your application must also be registered in the identity service for the Ordo platform – see ‘Our Security Model’ below.
Platform API calls will require both the subscription key and the access token obtained from the Ordo identity service.
To access our production APIs contact us at email@example.com stating the products you would like to subscribe to. We will then provide you with the necessary subscription keys. We will also require the identity service details for your production environment – see ‘Our Security Model’ below.
Our Security Model
The Ordo sandbox and production environment both use an Identity Service to provide Authentication and Authorisation services. Each client application will be assigned a set of credentials which must be presented to the Identity Service whenever it is used.
Contact us at firstname.lastname@example.org and provide the following using this form for the sandbox and this form for the production environment. Please ensure you have completed your sandbox activity before requesting access to the production environment.
Details of the client application.
Logout redirection URLs.
CORS origins to be used in the authentication process.
Ordo will then provide you with a Client Id and Client Secret for use with the Identity Service.
Further details can be found here.
A prerequisite for customers using Ordo’s Production APIs is testing within the Ordo Sandbox environment. There are three stages of client testing that are outlined below:
Connectivity Testing; which confirms connectivity between the client’s own test environment and the Ordo sandbox. This process is outlined in the Ordo Security Model.
Functional Testing; which confirms the ability to send, receive and respond to smart requests and notifications sent by the Ordo client (Biller) to their own customer base.
Non-Functional testing; which confirms the ability to process smart requests at expected volumes.
The full scope of the testing requirements will be agreed with individual clients and are based upon which Ordo product the client wishes to provide for its own customer base. Further details can be found here.
Our Business Models
Ordo is a Request for Payment provider that harnesses the potential of Open Banking to deliver a better way for businesses to bill their customers, and for those customers to pay in a secure, cost-effective way.
Ordo has three core options for how our billing clients work with Ordo. Two are available for all clients; ‘Send via Ordo’ and ‘Biller delivery” and the third is specific to financial institutions that want to receive money into a large number of separate accounts; e.g. to support their savings or loan repayment propositions.
Send Via Ordo
This is the simplest service; you submit Requests for Payment and Ordo sends them out to the payer. Anything addressed to a mobile number will go from Ordo’s SMS service. Anything addressed to an email address will go with a 'from' name of “BillerName via Ordo <email@example.com>”
Designed for billers who want to manage the presentment of the smart request to their customer themselves. Ordo returns a URL unique to each smart request, which you present to your customer by whatever medium you want. Possibilities include:
E-commerce ‘Pay Now’ button on a web-page
Available to firms authorised to hold client funds, these APIs enable you to add as many customer accounts to your ‘send’ capability as you like. Each smart request would present the name of the account that funds are to go to – giving a more personalised touch to your services.
Used in conjunction with ‘Biller delivery’ you can tailor the message you give your customers, driving up savings deposits, improving your reconciliation of incoming funds, and boosting your liquidity, whilst at the same time making it simpler for your customers to pay into their accounts.
If you need assistance in determining which Ordo Product best meets the needs of your Business, please contact firstname.lastname@example.org to arrange a call with our experts.
To review our API’s then please subscribe to each relevant Product under our Product page.