Skip to main content
POST
Add Descriptors to Enrollment
Every requested descriptor is sent to the provider. A re-added descriptor that is Disabled or Rejected is reset to Pending first. Descriptors that are Pending, Processing, InReview, Enrolled or Surpressed keep their status, unless unenrolRequestedAt is 2 hours or older. Such a row is also reset to Pending first. If a requested descriptor has unenrolRequestedAt set less than 2 hours ago and is not Disabled or Rejected, the whole request is rejected with 409 and nothing is changed. Retry after its status changes to Disabled, or after 2 hours. RDR enrollments are rejected with 422: RDR enrolls by bins and caids, so use POST /dispute/disputes/alert-enrollments instead.

Authorizations

Authorization
string
header
required

You can use an OAuth2 JWT bearer token in the Authorization header of your API requests for supported endpoints: Authorization: Bearer <YOUR_JWT_HERE>. These tokens are valid for 10 minutes and can be requested via the access token endpoint endpoint.

Scopes

disputes:update

Headers

x-idempotency-key
string<uuid>
required

Idempotency key to be used. Sending again the same key would return the same result without re-executing the update.

Path Parameters

enrollmentId
string<uuid>
required

The enrollment ID.

Body

application/json
descriptors
string[]
required

The merchant descriptors to add to the enrollment.

Minimum array length: 1

Response

Descriptors added to enrollment.