Skip to main content

Merchant Network Tokenization enrollment

POST 
/createNtEnrollment

Records a pending Network Tokenization (TRID) enrollment request for the given merchant. Actual TRID provisioning runs asynchronously after the request is approved.

Required permissions​

Authorization is evaluated against the tenant the provisioning API key belongs to. That tenant must hold the tokenization.network-tokenization.enrollment.create ability. The check resolves the tenant's effective abilities including parent inheritance, so a grant on a parent tenant covers its sub-tenants automatically. Without the ability the call returns NOT_ALLOWED.

Auto-accept​

By default a new enrollment is created with status pending and a reviewer is notified. If the caller tenant additionally holds the tokenization.network-tokenization.enrollment.auto-accept-via-provisioning-api ability, the enrollment is automatically approved and queued for processing without reviewer involvement. The request and response contract is identical in both cases.

Rate limit

Please be aware of the rate limit for this API endpoint:

  • Total limit: Each unique API user is limited to to 100 requests per 60-second window.

If these limits are exceeded, the server will respond with a HTTP 429 status code, indicating too many requests. Please ensure to manage your requests within these limits to maintain uninterrupted service.

Request​

Responses​

The enrollment request was successfully created.