Live
  • Identity
Available in
  • Germany,
  • Netherlands,
  • Spain,
  • UK

Match

1.1.1

Match verifies identity attributes linked to a customer’s mobile phone number. This creates a high trust and low friction method for verifying identity online.

This API follows the GSMA Mobile Connect specification.

Try it out

Live
  • Identity
Available in
  • Germany,
  • Netherlands,
  • Spain,
  • UK

Match

1.1.1

Match verifies identity attributes linked to a customer’s mobile phone number. This creates a high trust and low friction method for verifying identity online.

This API follows the GSMA Mobile Connect specification.

Try it out

Lightbulb icon
It can be used for
  • Identity protection
  • Higher conversion rates
  • Secure user data query

API Information

Version v1.1.1
Protocol HTTPS
Sandbox URL https://api-sandbox.vf-dmp.engineering.vodafone.com
Live URL https://eu3.api.vodafone.com
Version history 1.1.1
Release date September 2023
Status Live
Description The Match service is based on the GSMA Mobile Connect global standard for KYC (Know Your Customer) with a set of Vodafone extensions.

How it works

  1. The customer goes to checkout from the website and pays for the goods they want to purchase. 
  2. The website (or app) asks them to register their details for the first time.
  3. The app sends a request to Vodafone's Match API.
  4. The API compares the attributes submitted by the user with the details that Vodafone holds against that user, and sends a response for each of the API attributes. See the example.
  5. If the details don’t match, further identity checks may be required, so that the retailer can ensure that the user is real.

Example:

Attribute Example response
given_name_match     Y
family_name_match   Y
houseno_or_housename_match N-AV
postal_code_match N-AV
birthdate_match N-AV
is_lost_stolen false
billing_segment PAYM
account_state active

Use case examples

Typical use cases for the Match API include:

  • Enrolling a customer on to new services (by re-using the validated user identity that Vodafone has previously captured).
  • Banks that need to verify new users by using Remote ID checks.
  • Banks that need to refresh their Know Your Customer (KYC) records.
  • Mobile wallet card enrolment.
  • Mobile wallet ID verification.
  • Compliance check for online gambling.

Run in Postman

To begin using the Vodafone workspace in Postman, please follow the steps below to create a set of credentials that can be used with our sandbox collections:

  • Register an account on https://developer.vodafone.com and create a sandbox app for the APIs that you are interested in.
  • Use the Client Key and Secret from your sandbox app to populate the relating variables in the "Sandbox Credentials" environment group in Postman.
  • Call the token endpoint to create a bearer token that is used in the API resource endpoint. Your client credentials will be taken from the environment variables and used in a basic OAuth flow.
  • You need to call the token end-point for each API as the API scope is held in the request body of the token call.
  • The last bearer token and trace ID will be stored in collection variables associated with the API solution that you have chosen.
  • You can use these collections as read-only or create a fork into your own personal workspace to edit the details.

You can access all of Vodafone's sandbox APIs in our Postman workspace by clicking the button below:

Run in Postman Button

What is Postman?

Postman is a popular development and testing tool that is widely used across the API developer community. It offers an easy to use interface for making HTTP requests, testing API responses and collaborating with team members. For more details, see postman.com

X Facebook

Vodafone Developer Portal

Discover, try, and purchase our APIs to start building your own apps