Enroll Descriptors for Dispute Alerts

Enroll one or more merchant descriptors with a pre-chargeback alert program. Runs synchronously and returns once the provider has accepted the enrollment. Behaviour depends on the program:

  • Ethoca / CDRN / RDR (actionable, descriptor-based): one or more
    descriptors are required. The request is forwarded to the provider
    (Chargeblast), which assigns a merchant reference. Returns once the
    provider has accepted the enrollment.

  • VerifiINFORM (account-level, reporting-only): no descriptors;
    externalReference (the Verifi INFORM merchant ID) is required instead.
    No provider API call is made — the enrollment row is created locally and
    used to resolve incoming TC40 and TC15 alert webhooks.

Re-enrolling an existing (providerConfigId, program) pair resumes that enrollment: for actionable programs it appends new descriptors to the existing provider merchant; for VerifiINFORM it updates the stored externalReference.

Body Params
uuid
required

The workspace the enrollment belongs to.

uuid
required
uuid
required
descriptors
array of strings

The merchant descriptors to enroll for alerts. Required for Ethoca and CDRN. RDR enrolls by bins/caids instead of descriptors. Must be empty or omitted for VerifiINFORM (account-level).

descriptors
bins
array of strings

RDR only. Card BINs to enroll, paired 1:1 with caids (bins[i] is confirmed against caids[i]). Required for RDR; omit for other programmes.

bins
caids
array of strings

RDR only. Card Acceptor IDs, paired 1:1 with bins. Required for RDR.

caids
string
enum
required

The network program to enroll in. Ethoca, CDRN, and RDR are actionable pre-chargeback alert programmes. Ethoca and CDRN enroll by descriptors; RDR enrolls by bins/caids. VerifiINFORM is Visa's account-level fraud-reporting feed (covering TC40, TC15, and future Verifi INFORM feeds) — it requires externalReference instead of descriptors, and a merchant enrolls once to receive all Verifi INFORM alert types. SAFE (Mastercard fraud feed) is not enrolled explicitly: it is automatically active on any Ethoca-enrolled merchant.

Allowed:
string

Optional provider ruleset to apply.

string

The Verifi INFORM merchant ID assigned when the merchant was onboarded to Verifi INFORM. Required for VerifiINFORM; Chargeblast uses this ID as the merchantId on all Verifi INFORM alert webhooks (TC40, TC15, …), so it must be stored for ingestion to resolve incoming alerts. Omit for actionable programmes (Ethoca, CDRN, RDR) where the connector assigns the reference at enrol time.

Headers
uuid
required

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

Responses
201

Enrollment created.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Choose an example:
application/json