Payment API

Overview

Account Details

Overview
Create an account
Update an account
Get account information

Authorisation Control

Overview
Authorisation Control Webhook

Authorisation Forwarding

Overview
Forward authorisation webhook

Card details

Overview
Create card
Update card
Get application
Update application
Get card
Get plastic
Get EMV scripts
Update plastic

Customer

Overview
Get customer information
Create a customer
Update a customer
Customer hierarchy

Exchange Rates API

Overview
Get ECB exchange rate
Get ECB supported currencies
Get FX exchange rates

ID

Overview
Initiate 3rd party authentication flow
Callback to complete authentication flow

Instalment

Overview
Instalment Controller

Invoice

Overview
Get invoice information
Update invoice information

Notification

Overview
Receive a notification

Overview
PIN operations with pre-shared key
PIN operations using PKI

PIN Control

Purchase Details

Overview
Trigger repricing
Get purchase details
Create purchase details
Update purchase details

RBA Forwarding

Overview
RBA forwarding

Repricing

Overview
Create repricing agreements
Get repricing agreements
Update repricing agreements
Create price lists
Get price lists
Update price lists

Transaction

Overview
Test transactions
Test authorizations
Get transaction data
Create transactions
Create fees
Update a transaction
Batch payment

Transfer API

Overview
Post account to account transfer
Account to account batch transfer
Post card to card transfer

Wallet

Overview
Push Provision
Activation data
Get tokens

Test API

Overview
test-auth-request-templates
test-authorizations

Hierarchy API

Overview
Card Hierarchy Management
Card Hierarchy Group Management
Card Management in Card Hierarchy Groups

Spend Control API

Overview
Rule Sets Endpoints
Rules Endpoints
Spend Control Test Endpoint

PIN Control handling

Request PIN Control access token by plasticId.

This operation is used to create the PIN control access token.

The successful response from this call returns an id, a pinURL for mobile device webview and pinFrameURL for an iframe in desktop browser flow. Id is valid for 30 seconds.

For mobile webview, device should be instructed to do a POST call to the pinURL with the content of the id in a form field named controlId.

For desktop browser flow, iframe should be opened to pinFrameURL with query parameter key, which needs to be agreed with Enfuce beforehand. After iframe has been loaded, browser should make a window.postMessage() call to the iframe. The message object should contain fields operation (with value view-pin or set-pin) and controlId.

POST

plastic

{plasticId}

curl --request POST \
  --url https://integration-api-cat2./%7B{environment}%7D.ext.%7B{realm}%7D.cia.enfuce.com/pincontrol/v2/plastic/{plasticId} \
  --header 'Content-Type: application/json' \
  --data '{
  "scope": "VIEW_PIN"
}'

{
  "id": "<string>",
  "pinURL": "<string>",
  "pinFrameURL": "<string>"
}

Path Parameters

plasticId

string

required

The id of the plastic for which the PIN should be accessed

Query Parameters

auditUser

string

required

The audit user to log the request

Body

application/json

The related PIN control request data

scope

enum<string>

required

Describes the scope of the operation that is authorized by the user.

Available options:

VIEW_PIN,

SET_PIN

Response

201

application/json

Successful creation of the access token

string

required

The ID of this PIN Control access token.

pinURL

string

The URL that the cardholder's mobile device webview should browse to for accessing the PIN.

pinFrameURL

string

The URL of the iframe for desktop browser based flows for accessing PIN.

Overview Request PIN Control access token by plasticId (Deprecated)

curl --request POST \
  --url https://integration-api-cat2./%7B{environment}%7D.ext.%7B{realm}%7D.cia.enfuce.com/pincontrol/v2/plastic/{plasticId} \
  --header 'Content-Type: application/json' \
  --data '{
  "scope": "VIEW_PIN"
}'

{
  "id": "<string>",
  "pinURL": "<string>",
  "pinFrameURL": "<string>"
}