Register end users via API

Register end users in D1 to link cards to an end user.

This is a backend-to-backend flow between your issuer backend and the D1 backend.

For entity definitions, see D1 concepts.

When end user registration is required

End user registration depends on how you use D1:

• Card creation model: Register the end user before you create any card in D1.

• Card registration model: End user registration can be:

  • Explicit, via the D1 API.

  • Implicit, during card creation or card registration (based on consumerId).

Define consumerId

Your issuer backend provides a consumerId for each end user.

D1 uses consumerId to identify the end user.

It is used in the D1 API, D1 SDK, and D1 portal.

consumerId must not contain personal information.

Do not include name, email address, phone number, PAN, or similar data.

Choose a registration model

Choose whether the D1 backend stores end user personal information.

This choice changes your registration flow.

Store personal information in the D1 backend

Use this model when you want D1 to store personal information.

D1 can then cache the data.

This reduces calls to your issuer backend.

Provide the mandatory fields in personalInformation.

See the schema in Register consumer.

Keep D1 up to date when personal information changes.

Use Update consumer.

End user registration flow between the issuer backend and the D1 backend.

API calls:

• Register consumer (with personalInformation)

• Update consumer

Do not store personal information in the D1 backend

Use this model when D1 must not store personal information.

You can still register the end user explicitly.

Call Register consumer without personalInformation.

You can also skip explicit registration.

Rely on implicit registration during card creation or card registration.

When D1 needs personal information, it calls your issuer backend.

For example, D1 can do this for Tokenization.

It uses Get consumer information.

If you already use Register consumer 1.0, you can keep using it. Use the v2 endpoints for new integrations.

API calls:

• Register consumer (without personalInformation)

• Get consumer information

Endpoint summary

From the issuer backend to the D1 backend:

• Register consumer

• Update consumer (if D1 stores personal information)

• Get consumer information (if D1 does not store personal information)