EMV List
Retrieve the EMV information of a given token bearer.
GET /api/v2/emv
Authorization: Bearer {jwt}Request
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| pageSize | query | number | false | Default 10, query all use -1 |
| pageNumber | query | number | false | Default 1 |
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK (opens in a new tab) | Example response | Wrapper: Response<T> Data: EmvInfo |
| 401 | Unauthorized | Authentication failed | Data: Response Code |
200 Response
{
"msg": "SUCCESS",
"code": 0,
"data": {
"total": 9,
"current": 1,
"records": [
{
"emvName": "l3-mastercard",
"createdAt": "2024-11-26T02:12:57+0000",
"groupId": "G-15450991",
"paymentMethod": "02",
"id": 1675,
"params": "{\"appVersion\":\"0002\",\"clTransLimit\":99999999,\"defaultDDOL\":\"039F3704\",\"isNewCVMRuleForMC\":true,\"kernelConfiguration\":\"b0\",\"cvmCapabilityCVMRequired\":\"20\",\"clFloorLimit\":0,\"terminalRiskMgmtData\":\"082C00800000000000\",\"defaultTDOL\":\"0F9F02065F2A029A039C0195059F3704\",\"clCVMLimit\":100000,\"cvmCapabilityNoCVM\":\"08\",\"aid\":\"A0000000041010\"}",
"aid": "A0000000041010",
"emvVersion": "v1",
"updatedAt": "2024-11-26T02:12:57+0000"
}
],
"hasNext": false
}
}EMV Create
POST /api/v2/emv
Content-Type: application/json
Authorization: Bearer {jwt}Request
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| params | body | object | true | EMV parameters object containing configuration values |
| emvName | body | string | true | Name of the EMV configuration |
| paymentMethod | body | string | true | Payment method identifier |
EMV Parameters
| Object Key | Type | Comments |
|---|---|---|
| aid | String | List of Application Identifiers (AID) |
| appVersion | String | application version |
| terminalTransactionQualifiers | String | Not available for MC and Amex |
| clFloorLimit | Long | Contactless floor limit, can keep it as 0 for online only |
| clTransLimit | Long | Contactless transaction limit, transaction will be declined if auth amount is exceed this limit |
| clCVMLimit | Long | Contactless CVM limit, If the transaction amount is greater than or equal to the Reader CVM Required Limit, then the reader requires a CVM for the transaction, VISA/UPI/DISCOVER/JCB(greater or equal), MC/Amex(greater) |
| terminalRiskMgmtData | String | Available for MC only |
| defaultDDOL | String | Dynamic Data Authentication Data Object List, Can keep the value in json file as default or "039F3704" |
| defaultTDOL | String | Default Transaction Certificate Data Object List, Can keep the value in json file as default or "0F9F02065F2A029A039C0195059F3704" |
| kernelConfiguration | String | Tag DF811B Available for MC only |
| isNewCVMRuleForMC | boolean | Available for MC only, default is false |
| cvmCapabilityCVMRequired | String | Tag DF8118 |
| cvmCapabilityNoCVM | String | Tag DF8119 |
Body example
{
"params": {
"aid": "string",
"appVersion": "string",
"clCVMLimit": 0,
"clFloorLimit": 0,
"clTransLimit": 0,
"defaultDDOL": "string",
"defaultTDOL": "string",
"isNewCVMRuleForMC": true,
"terminalRiskMgmtData": "string",
"terminalTransactionQualifiers": "string"
},
"emvName": "string",
"paymentMethod": "string"
}Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK (opens in a new tab) | Example response | Inline |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| id | number | false | none | none |
EMV Delete
DELETE /api/v2/emv/{emvId}
Authorization: Bearer {jwt}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| emvId | path | string | true | none |
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK (opens in a new tab) | OK | None |
EMV Update
PUT /api/v2/emv/{emvId}
Content-Type: application/json
Authorization: Bearer {jwt}Request
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| params | body | object | true | EMV parameters object containing configuration values |
| emvName | body | string | true | Name of the EMV configuration |
| paymentMethod | body | string | true | Payment method identifier |
Params
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK (opens in a new tab) | Example response | Inline |
Response Schema
Status Code 200
| Name | Type | Required | Restrictions | Description |
|---|---|---|---|---|
| id | number | false | none | none |