Home
Home
  1. Home
  • Welcome
    • About Ontime
    • Overview
    • Test and Learn Projects
  • Authentication
  • Availability Check
    • Light Availability Check
      POST
    • Full Availability Check
      POST
  • Payment Management
    • Mandates
      • Create a new mandate
      • Cancel an existing mandate
      • Get a Mandate
      • Get many Mandates
    • Payment Requests
      • Instruct a new payment request
      • Cancel an existing payment request
      • Get a Payment
      • Get many Payments
  • Payouts
    • Get a Payout
      GET
    • Get Available Payouts
      GET
  • Webhooks
    • Mandate Created/Updated
    • Payment Request Created/Updated
    • Payout Created
  1. Home

Availability Check

Purpose – Confirms if payroll deduction is available for the specified Consumer.
There are two types of availability check; Light and Full.

Light Availability Check#

Light allows you to find the probability of payroll deduction availability without requiring the consumer's National Registration Number. The more data points supplied into this match, the more confident we can be of the result.

Full Availability Check#

Full allows you to get a confirmed availability result by also supplying the consumer's National Registration Number. If provided by the Payroll Provider, we will also return employment data for the consumer to help with your decisioning processes.

Data Flow#

1. Biller calls the Ontime Availability Check Endpoint#

GDPR and data sharing
The employee should be informed about the data sharing in the Biller's Privacy Policy and in the customer journey.
When you check if payroll deduction is available to the customer you will be passing consumer data to Ontime. It is the caller's responsbility to ensure they have an appropriate and legitimate legal basis to pass consumer data to Ontime.

2. Payroll Verification#

Ontime calls each of its Payroll Partners partners to see whether the Consumer is paid through their software. Ontime shares the following data:
Consumer Data ItemPurposeLightFull
Given NameKey data pointrequiredrequired
Family NameKey data pointrequiredrequired
Date of BirthKey data pointrequiredrequired
Postal CodeSupporting data pointoptionalrequired
National Registration NumberGuarantees availability statusoptionalrequired
Email AddressSupporting data pointoptionaloptional
Phone NumberSupporting data pointoptionaloptional

3. Ontime confirms consumer's availability status#

Ontime returns a positive availability status. You can now offer the customer a product that is paid through Ontime.
LightAvailabilityCheckResponse

FullAvailabilityCheckResponse

The AvailabilityCheck does not require an Idempotency-Key header value to be passed. The AvailabilityCheck can be called frequently and will always return the current status.
Previous
Authentication
Next
Light Availability Check