# Enfuce

- [Introduction](https://nextgen-docs.enfuce.com/guides/overview.md)
- [Data Files](https://nextgen-docs.enfuce.com/guides/getting-started/data-sharing.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/cards/overview.md)
- [Status](https://nextgen-docs.enfuce.com/guides/cards/card-status.md)
- [Card Renewal, Reissue, Replacement](https://nextgen-docs.enfuce.com/guides/cards/card-renewal-reissue-replacement.md)
- [Card Creation Via Endpoint](https://nextgen-docs.enfuce.com/guides/cards/card-creation-via-endpoint.md)
- [Card Embossing](https://nextgen-docs.enfuce.com/guides/cards/card-embossing.md)
- [View Card Data](https://nextgen-docs.enfuce.com/guides/cards/card-data.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/cardholders/cardholder-overview.md)
- [PIN](https://nextgen-docs.enfuce.com/guides/pin/overview.md)
- [Status](https://nextgen-docs.enfuce.com/guides/pin/pin-status.md)
- [View PIN](https://nextgen-docs.enfuce.com/guides/pin/view-card-pin.md)
- [Set PIN](https://nextgen-docs.enfuce.com/guides/pin/set-pin.md)
- [Change PIN](https://nextgen-docs.enfuce.com/guides/pin/change-pin.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/wallet/introduction/overview.md)
- [Tokenisation](https://nextgen-docs.enfuce.com/guides/wallet/introduction/tokenisation.md)
- [Cardholder Authentication](https://nextgen-docs.enfuce.com/guides/wallet/introduction/cardholder-authentication.md)
- [Wallet Provisioning](https://nextgen-docs.enfuce.com/guides/wallet/introduction/provisioning.md)
- [Integration Checklist](https://nextgen-docs.enfuce.com/guides/wallet/introduction/integration-checklist.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/wallet/token-lifecycle/token-lifecycle-management-overview.md)
- [Token Lifecycle Management via Token API Endpoints](https://nextgen-docs.enfuce.com/guides/wallet/token-lifecycle/token-lifecycle-management-via-API.md)
- [MDES Token Connect](https://nextgen-docs.enfuce.com/guides/wallet/mdes-token-connect.md)
- [Introduction](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/introduction.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/cardholder-authentication/cardholder-authentication.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/cardholder-authentication/3DS/overview.md)
- [3DS Authentication API](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/cardholder-authentication/3DS/3DS-authentication-api.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/authorisation/authorisation.md)
- [Authorisation Message Types](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/authorisation/authorisation-types-transaction-flows.md)
- [Authorisation Request API Endpoint](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/authorisation/authorisation-request-message.md)
- [Authorisation Response](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/authorisation/authorisation-response.md)
- [Transaction Event Webhook](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/authorisation/transaction-event-webhook.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/clearing/clearing.md)
- [Ledger's Actions](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/clearing/issuer-ledger-actions.md)
- [Ledger Integration Use Cases](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/ledger-use-cases.md)
- [Issuer Fees](https://nextgen-docs.enfuce.com/guides/transaction-lifecycle/issuer-fees/issuer-fees.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/spend-controls/overview.md)
- [Regulatory and Fraud Spend Controls](https://nextgen-docs.enfuce.com/guides/spend-controls/regulatory-fraud-spend-controls.md)
- [Overview](https://nextgen-docs.enfuce.com/guides/exchange-rates/overview.md)
- [Overview](https://nextgen-docs.enfuce.com/api/introduction.md): Here you'll find documentation about Nextgen APIs.
- [Authentication](https://nextgen-docs.enfuce.com/api/authentication.md)
- [Authentication for Outgoing Endpoints and Webhook Notifications](https://nextgen-docs.enfuce.com/api/authentication-outgoing-endpoints-webhooks.md)
- [Overview](https://nextgen-docs.enfuce.com/api/cards/cards-api.md)
- [Create Card](https://nextgen-docs.enfuce.com/api/cards/post-card/create-card.md): Send a request to this endpoint to create a new card.
- [Get Card Applications for Main Card](https://nextgen-docs.enfuce.com/api/cards/get-card/get-cards.md): Send a request to this endpoint to return all card applications for a specific main card. If the main card does not exist, an empty array is returned.
- [Get Card](https://nextgen-docs.enfuce.com/api/cards/get-card/get-card.md)
- [Initiate Card Data Retrieval](https://nextgen-docs.enfuce.com/api/cards/post-card/initiate-card-data-retrieval.md): Send a request to this endpoint when the cardholder wants to retrieve card data, such as PAN, expiry and CVV2/CVC2. If no sequence number is specified, the latest card version is used by default. Only card versions not in CLOSED status are allowed.
- [Partially Update Card](https://nextgen-docs.enfuce.com/api/cards/patch-card/partial-update-card.md): Send a request to this endpoint when you want to update details of a specific card.
- [Replace Card](https://nextgen-docs.enfuce.com/api/cards/post-card/replace-card.md): Send a request to this endpoint when you want to replace the current card. The old card is closed and a new card is issued, where the PAN and the expiry date are updated.
- [Reissue Card](https://nextgen-docs.enfuce.com/api/cards/post-card/reissue-card.md): Send a request to this endpoint when you want to reissue a card.
- [Activate Card](https://nextgen-docs.enfuce.com/api/cards/post-card/activate-card.md): To change the latest card version status from `INITIAL` to `ACTIVE`, send a request to this endpoint.
- [Reorder PIN for Card](https://nextgen-docs.enfuce.com/api/cards/post-card/reorder-card-pin.md): Send a request to this endpoint when you want to reorder existing PIN for a plastic card, if the cardholder has forgotten it. The PIN is delivered to the `preferredPinAddress`. If `preferredPinAddress` is absent, the PIN is delivered to the `preferredCardAddress`.
- [Retrieve Manufacturing History of Card](https://nextgen-docs.enfuce.com/api/cards/get-card/card-manufacturing-history.md): Send a request to this endpoint to retrieve a detailed list of all past occurrences when the card has been physically manufactured.
- [Retrieve Card Data | Additional Method](https://nextgen-docs.enfuce.com/api/cards/post-card/additional-method-retrieve-card-data.md): This is a web service designed to retrieve the card data required for completing e-commerce payments — PAN, CVC2/CVV2, expiry date of the card can be retrieved. The returned payload is encrypted with an asymmetric public key; this enables end-to-end encryption to the card holder device. The paramete…
- [Request PIN Control Access Token](https://nextgen-docs.enfuce.com/api/cards/post-card/create-pin-control-access-token.md): Send a request to this endpoint to generate a PIN control access token for a specific card version. The requested `scope` determines which PIN operation the token authorises: `VIEW_PIN`, `SET_PIN` or `CHANGE_PIN`. If no `sequenceNumber` is provided, the latest card version is used.
- [Reset PIN Counter](https://nextgen-docs.enfuce.com/api/cards/post-card/reset-pin-counter.md): Send a request to this endpoint to reset the PIN counter to 1.
- [Card Webhook](https://nextgen-docs.enfuce.com/api/cards/webhook/card-webhook.md): This is not an endpoint. This is the description of a request that is sent to subscribed webhooks upon card creation, update or closure.
- [Overview](https://nextgen-docs.enfuce.com/api/cardholders/cardholders-api.md)
- [Create Cardholder](https://nextgen-docs.enfuce.com/api/cardholders/create-cardholder.md): Send a request to this endpoint to create a new cardholder record in Enfuce.
- [Get Cardholder by Cardholder ID](https://nextgen-docs.enfuce.com/api/cardholders/get-cardholders/get-cardholder.md): Send a request to this endpoint to retrieve details of a cardholder.
- [Retrieve List of Cardholders](https://nextgen-docs.enfuce.com/api/cardholders/get-cardholders/get-cardholders.md): Send a request to this endpoint to retrieve details of a cardholder that conforms with the parameters you have entered.
- [Get Cards by Cardholder ID](https://nextgen-docs.enfuce.com/api/cardholders/get-cardholders/get-cards-by-cardholder.md): Send a request to this endpoint to retrieve a list of main cards associated with a cardholder.
- [Update Cardholder](https://nextgen-docs.enfuce.com/api/cardholders/update-cardholder.md): Send a request to this endpoint to modify details of a cardholder.
- [Outgoing cardholder event webhook endpoint](https://nextgen-docs.enfuce.com/api/cardholders/webhook/cardholder-webhook.md): This is not an endpoint. This is the description of a request that is sent to subscribed webhooks upon cardholder creation or update.
- [Overview](https://nextgen-docs.enfuce.com/api/pin/pin-api.md)
- [Set PIN](https://nextgen-docs.enfuce.com/api/pin/set-pin.md): Send a request to this endpoint to set PIN for the latest card version.
- [Retrieve Encrypted PIN](https://nextgen-docs.enfuce.com/api/pin/view-pin.md): Send a request to this endpoint to retrieve the card PIN (ISO PIN Block Format 1) encrypted with temporary PIN encryption key (tzpk). The tzpk is encrypted with the provided ephemeral RSA 2048 bit public key. Steps for retrieving the ISO PIN Block Format 1: - Decrypt the tzpk with the RSA private ke…
- [Change PIN](https://nextgen-docs.enfuce.com/api/pin/change-pin.md): Send a request to this endpoint to change PIN of a specific card version.
- [Overview](https://nextgen-docs.enfuce.com/api/wallet/wallet-api.md)
- [Apple Pay push provisioning](https://nextgen-docs.enfuce.com/api/wallet/apple-pay.md): This endpoint is only used for Apple Pay push provisioning. It requires a certificate and a nonce from Apple.
- [Google Pay push provisioning](https://nextgen-docs.enfuce.com/api/wallet/google-pay.md): This endpoint is only used for Google Pay push provisioning.
- [Samsung Pay push provisioning](https://nextgen-docs.enfuce.com/api/wallet/samsung-pay.md): This endpoint is only used for Samsung Pay push provisioning.
- [Generate activation data for MDES/VTS](https://nextgen-docs.enfuce.com/api/wallet/token/activate-token-by-card-id.md): This operation will generate activation data with encrypted card data to passed on to MDES/VTS
- [Activate token by its card scheme's unique reference](https://nextgen-docs.enfuce.com/api/wallet/token/activate-token-by-token-id.md): Activates an inactive token (for example, completing the “orange flow” where cardholder needs to activate a token after provisioning).
- [Lists tokens for a card](https://nextgen-docs.enfuce.com/api/wallet/token/get-tokens-by-card-id.md): Returns a list of tokens associated with the specified card ID.
- [Get token by token unique reference ID](https://nextgen-docs.enfuce.com/api/wallet/token/get-tokens-by-token-id.md): Retrieves details of a token by its card scheme's unique reference. Typical use case: allow customer systems to display token information.
- [Suspend token by its card scheme's unique reference](https://nextgen-docs.enfuce.com/api/wallet/token/suspend-token.md): Temporarily suspends a token to prevent usage without deactivating it permanently. Typical use case: cardholder reports a lost device but may recover it.
- [Unsuspend token by its card scheme's unique reference](https://nextgen-docs.enfuce.com/api/wallet/token/unsuspend-token.md): Brings a suspended token back into active use, for example, when a cardholder finds their previously lost device.
- [Deactivate token by its card scheme's unique reference](https://nextgen-docs.enfuce.com/api/wallet/token/deactivate-token.md): Permanently deactivates a token so it can never be used again. Typical use case: confirmed theft or device permanently compromised.
- [Push Cards to Token Requestors](https://nextgen-docs.enfuce.com/api/wallet/mdes-token-connect/token-connect-push.md): Send a request to this endpoint to add the cards to the digital wallet or the merchant.
- [List Eligible Token Requestors
](https://nextgen-docs.enfuce.com/api/wallet/mdes-token-connect/token-connect-requestors.md): Send a request to this endpoint to return a list of eligible token requestors (Samsung Pay and/order Click to Pay), as available for the specific card program.
- [Outgoing token event webhook endpoint](https://nextgen-docs.enfuce.com/api/wallet/webhook/token-webhook.md): This is not an endpoint. This is the description of a request that is sent to subscribed webhooks upon token creation or update.
- [API Endpoints](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/transaction-lifecycle.md)
- [Overview](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/3DS/3DS-api-endpoints.md)
- [Initiate OOB Authentication Challenge](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/3DS/OOB-authentication-challenge-webhook-notification.md): In Out-of-Band (OOB) authentication flow, Enfuce sends an authentication challenge webhook notification to the issuer's registered endpoint for cardholder's approval.
- [Submit Authentication Challenge Result](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/3DS/submit-authentication-challenge-result.md): Send a request to this endpoint with the authentication challenge result.
- [Overview](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/authorisation-control/authorisation-request-api-endpoints.md)
- [Authorisation Request API](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/authorisation-control/authorisation-request-openapi.md): Enfuce sends an authorisation request to the issuer/ledger, when it expects an authorisation decision from the recipient.
- [Transaction event webhook](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/transaction-event/transaction-event-webhook-openapi.md): Enfuce sends a transaction event webhook to inform you about the current processing state. You might need to adjust the ledger balance, if impacted.
- [Overview](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-api-endpoints.md)
- [Send an Authorization Request](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-authorisation-request.md): Send a request to this endpoint to create an initial authorisation request. <Info>The communications between the card Schemes and the processor are in ISO 8583 format.</Info>
- [Send an Authorization Reversal](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-authorisation-reversal.md): Send a request to this endpoint to completely or partially cancel a previously approved authorised amount held in the cardholder's account. References the original authorisation request by its `metadata.id` (returned in the response of the initial authorisation request).
- [Send an Authorisation Adjustment](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-authorisation-adjustment.md): Send a request to this endpoint to partially reverse (decrease) a previous authorisation. References the original authorization by `metadata.id`. The `transactionData` sent in the request payload reflects the amount that is aligned with the final clearing amount.
- [Send an Incremental Authorisation](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-authorisation-incremental.md): Send a request to this endpoint to increase the total authorised amount, submitted as an additional request after the initial authorisation request. This is commonly used in hospitality and car rental scenarios where the final amount is not known at check-in.
- [Send a Stand-In Processing (STIP) Transaction](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-authorisation-STIP.md): Send a request to this endpoint to simulate a STIP transaction. The card Scheme processes the authorisation request on behalf of the processor, when the processor is unavailable.
- [Send an Authorisation Advice](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-authorisation-advice.md): Send a request to this endpoint to simulate an authorisation event that has already occurred (Enfuce forwards this message to the ledger via the Transaction Event webhook interface with the `ADVICE` `messageFunction` (MTI 0120). References to a previous authorisation message with `metadata.id` (retu…
- [Send Purge Authorisation Request](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-purge-authorisation.md): Send a request to this endpoint to simulate a purged authorised request.
- [Send an clearing request](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-clearing-transaction.md): Creates a clearing request for authorisation request
- [Send Batch Transactions](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-batch-transactions.md): Send a request to this endpoint to trigger a series of transactions in sequence. Each transaction consists of an authorisation description with a series of events.
- [Send Batch Authorisation Request (legacy load-test)](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/test-api/test-batch-transactions-legacy.md): A request to this endpoint sends `amount` randomized authorisation requests, based on the provided request template. Transaction amounts are randomized per request.
- [Overview](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/clearing-file-copy/clearing-file-copy-schema-contents.md)
- [Clearing file copy schema](https://nextgen-docs.enfuce.com/api/transaction-lifecycle/clearing-file-copy/clearing-file-copy-schema.md)
- [Overview](https://nextgen-docs.enfuce.com/api/spend-control/spend-control-api-endpoints.md)
- [Get rule set by entity id](https://nextgen-docs.enfuce.com/api/spend-control/rule-sets/get-rule-set-by-entity-id.md): Returns rule sets by entity.
- [Get rule set by rule set id](https://nextgen-docs.enfuce.com/api/spend-control/rule-sets/get-rule-set-by-rule-set-id.md): Returns a single rule set by id.
- [Create entity bindings](https://nextgen-docs.enfuce.com/api/spend-control/rule-sets/create-entity-bindings.md): Adds entity bindings to rule set.
- [Get entities by rule type id](https://nextgen-docs.enfuce.com/api/spend-control/rule-sets/get-entities-by-rule-type-id.md): Return entities bound to rule set.
- [Delete entity by rule set id](https://nextgen-docs.enfuce.com/api/spend-control/rule-sets/delete-entity-by-rule-set-id.md): Removes an entity binding from a rule set.
- [Get rule by rule id](https://nextgen-docs.enfuce.com/api/spend-control/rules/get-rule-by-rule-id.md): Retrieves a rule with parameters by id.
- [Create parameters by rule id](https://nextgen-docs.enfuce.com/api/spend-control/rules/create-parameters-by-rule-id.md): Adds parameter to a rule for a given card. These parameters will be used instead of rule defaults when processing rule for the card.
- [Update parameters for rules](https://nextgen-docs.enfuce.com/api/spend-control/rules/update-parameters-for-rules.md): Updates parameters for a rule for the given card.
- [Delete parameters for rules](https://nextgen-docs.enfuce.com/api/spend-control/rules/delete-parameters-for-rules.md): Removes parameter from a rule for a given card. Default parameter on rule will be used when processing rule for the card.
- [Get parameters for entity](https://nextgen-docs.enfuce.com/api/spend-control/parameters/get-parameters-for-entity.md): Returns all parameters for an entity.
- [Overview](https://nextgen-docs.enfuce.com/api/spend-control/velocity-buckets/velocity-bucket-overview.md)
- [Get velocity bucket](https://nextgen-docs.enfuce.com/api/spend-control/velocity-buckets/get-velocity-bucket.md): Returns velocity buckets containing the current utilization of every cumulative rule for a given card. The returned counter and amount represent used capacity, not remaining capacity: they increase when a new transaction falls under an active rule and decrease after an authorization is purged or rev…
- [Delete velocity bucket](https://nextgen-docs.enfuce.com/api/spend-control/velocity-buckets/delete-velocity-bucket.md): Manually resets the current utilization for a given card and rule by deleting its velocity bucket data. Note that this is separate from automatic interval expiry.
- [Overview](https://nextgen-docs.enfuce.com/api/exchange-rate/exchange-rate-api.md)
- [FX Exchange Rates for supported payment schemas (Visa, Mastercard)](https://nextgen-docs.enfuce.com/api/exchange-rate/post-FX-exchange-rates.md): This operation is to get the Visa/Mastercard treasury FX rates for a given “from” and “to” currency pair.
- [ECB Supported Currencies](https://nextgen-docs.enfuce.com/api/exchange-rate/get-ECB-supported-exchange-currencies.md): This operation is to get ECB supported currenciess
- [ECB Exchange Rates](https://nextgen-docs.enfuce.com/api/exchange-rate/get-ECB-exchange-rate.md): This operation is to get ECB rate for a given “from” and “to” currency pair.
- [Release Notes](https://nextgen-docs.enfuce.com/updates/release-notes.md)

## OpenAPI Specs

- [authorisation-control-v1.openapi](/json-files/authorisation-control-v1.openapi.json)
- [card-event.openapi](/json-files/card-event.openapi.json)
- [card.openapi](/json-files/card.openapi.json)
- [cardholder-event.openapi](/json-files/cardholder-event.openapi.json)
- [cardholder.openapi](/json-files/cardholder.openapi.json)
- [cards-v1.openapi](/json-files/cards-v1.openapi.json)
- [clearing-file-copy-v1.openapi](/json-files/clearing-file-copy-v1.openapi.json)
- [fx.openapi](/json-files/fx.openapi.json)
- [mycore-test-api.openapi](/json-files/mycore-test-api.openapi.json)
- [pin.openapi](/json-files/pin.openapi.json)
- [spend-control](/json-files/spend-control.json)
- [standard-spend-control-v1.openapi](/json-files/standard-spend-control-v1.openapi.json)
- [threeds-oob-v1.openapi](/json-files/threeds-oob-v1.openapi.json)
- [threeds-v1.openapi](/json-files/threeds-v1.openapi.json)
- [token-event.openapi](/json-files/token-event.openapi.json)
- [transaction-event-v1.openapi](/json-files/transaction-event-v1.openapi.json)
- [velocity-buckets-v1.openapi](/json-files/velocity-buckets-v1.openapi.json)
- [wallet.openapi](/json-files/wallet.openapi.json)

## Optional

- [Platform](https://enfuce.com/product/platform/)