Enrollment Status

Payment method enrollment statuses and lifecycle during customer session enrollment flows.

Yuno enables customers to enroll payment methods for seamless future purchases across Full or Lite payment implementations. Each payment method goes through a defined status lifecycle during the enrollment process.

Enrollment statuses apply to both Full SDK and Lite checkout implementations. These are distinct from payment statuses. They track the credential vaulting lifecycle, not a payment transaction.

Enrollment Status Values

CREATED · string

Initial state at the time of creating a payment method. The enrollment process has not yet started.

READY_TO_ENROLL · string

The payment method is available for enrollment. The customer can proceed with the enrollment flow in the SDK.

ENROLL_IN_PROCESS · string

The payment method enrollment is being processed. Yuno is communicating with the provider to complete the enrollment.

ENROLLED · string

The payment method enrollment has been successful. A vaulted_token is now available for future payments.

UNENROLL_IN_PROCESS · string

Removal of the enrolled payment method is underway. The unenrollment request has been sent to the provider.

UNENROLLED · string

The payment method has been unenrolled. The vaulted_token is no longer valid for future payments.

DECLINED · string

The payment method enrollment failed processing at the provider level.

REJECTED · string

Yuno has declined the enrollment request. This may occur due to risk rules or validation failures.

CANCELED · string

The enrollment was terminated by the user or system before completion.

EXPIRED · string

The payment method or enrollment session has reached its expiration date before completing enrollment.

ERROR · string

There was an error in the enrollment of the payment method. This is typically a transient issue. Retry the enrollment.

Status Lifecycle

Enrollment statuses progress through the following phases:

Phase	Statuses	Description
Initial	CREATED	Payment method record created, enrollment not started
Ready	READY_TO_ENROLL	Awaiting customer action in the SDK
Processing	ENROLL_IN_PROCESS, UNENROLL_IN_PROCESS	Provider communication in progress
Success	ENROLLED, UNENROLLED	Terminal success states
Failure	DECLINED, REJECTED, CANCELED, EXPIRED, ERROR	Terminal failure states

Enrollment Flow

A typical enrollment follows these steps:

1. Create a Customer Session. Generates an sdk_token scoped to the customer.
2. Initialize the SDK. Use the sdk_token to render the enrollment UI on the client.
3. Customer submits credentials. The SDK tokenizes the card and begins enrollment.
4. Monitor status. The payment method transitions through CREATED → READY_TO_ENROLL → ENROLL_IN_PROCESS → ENROLLED.
5. Use the vaulted token. Once ENROLLED, the vaulted_token can be used in Checkout Sessions for one-click payments.

If enrollment results in ERROR, the issue is typically transient. Retry by creating a new Customer Session and re-initiating the enrollment flow. Do not reuse the same session.

Related Pages

• Customer Session Object. The session used to initiate enrollment
• Create Customer Session. POST /v1/customers/{customer_id}/sessions
• Payment Method Object. The enrolled payment method record
• Enroll Payment Method. POST /v1/customers/{customer_id}/payment-methods
• Unenroll Payment Method. DELETE /v1/customers/{customer_id}/payment-methods/{id}
• Enrollment Guide. Step-by-step SDK enrollment guide