| Key | Format | Condition | Description | |
|---|---|---|---|---|
| 1 | type | object | M | Type of credential on file payment. |
| 2 | initialPayment | boolean | M | Indicates whether a card on file transaction is the first one in a series of transactions (establishment) or a subsequent transaction. |
| 3 | useCase | string | O | Type of use case that is intended. |
type
| Key | Format | Condition | Description | |
|---|---|---|---|---|
| 1 | recurring | object | C | Recurring payments are a series of transactions processed persuant to an agreement between a cardholder and a merchant where the cardholder purchases goods or services over a period of time through a number of separate transactions. Please note that in the context of PSD2 and SCA requirements the European Banking Authority (EBA) describes recurring payments as a series of transactions with the same amount and with the same payee. |
| 2 | unscheduled | string | C | Value indicating the party that initiates a credential on file transaction that does not occur on a fixed schedule. Values accpeted:
|
| Key | Format | CND | Description | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | recurring | object | C | Recurring payments are a series of transactions processed persuant to an agreement between a cardholder and a merchant where the cardholder purchases goods or services over a period of time through a number of separate transactions. Please note that in the context of PSD2 and SCA requirements the European Banking Authority (EBA) describes recurring payments as a series of transactions with the same amount and with the same payee. In conjunction with useCase (optional):
| ||||||||||||||
| 2 | unscheduled | string | C | Value indicating the party that initiates a credential on file transaction that does not occur on a fixed schedule.
In conjunction with useCase (optional):
|
recurring
| Key | Format | Condition | Description | |
|---|---|---|---|---|
| 1 | recurringFrequency | integer | M | Indicates the number of days between authorisations. |
| 2 | recurringStartDate | string | O | Determines the date of the first authorization according to the recurring mandate. |
| 3 | recurringExpiryDate | string | M | Date after which no further authorisations shall be performed. |
Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://paymentpage.axepta.bnpparibas/schemas/credentialOnFile.json",
"title": "credentialOnFile",
"description": "Credential-on-File Transactions",
"type": "object",
"properties": {
"type": {
"type": "object",
"properties": {
"recurring": {
"type": "object",
"properties": {
"recurringFrequency": {
"type": "integer",
"minimum": 1,
"maximum": 9999,
"description": "Indicates the minimum number of days between recurring authorizations."
},
"recurringStartDate": {
"type": "string",
"format": "full-date",
"description": "YYYY-MM-DD"
},
"recurringExpiryDate": {
"type": "string",
"format": "full-date",
"description": "YYYY-MM-DD"
}
},
"required": ["recurringExpiryDate", "recurringFrequency"],
"additionalProperties": false
},
"unscheduled": {
"type": "string",
"enum": ["CIT", "MIT"]
}
},
"oneOf": [
{"required": ["recurring"]},
{"required": ["installments"]},
{"required": ["unscheduled"]}
],
"additionalProperties": false
},
"initialPayment": {
"type": "boolean"
}
},
"required": ["type", "initialPayment"],
"additionalProperties": false
}
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://www.computop-paygate.com/schemas/credentialOnFile.json",
"title": "credentialOnFile",
"description": "Credential-on-File Transactions",
"type": "object",
"examples": [
{
"type": {
"recurring": {
"recurringFrequency": 30,
"recurringStartDate": "2019-09-14",
"recurringExpiryDate": "2020-09-14"
}
},
"initialPayment": true
},
{
"type": {
"unscheduled": "CIT"
},
"initialPayment": true
},
{
"type": {
"unscheduled": "CIT"
},
"initialPayment": true,
"useCase":"cof"
},
],
"properties": {
"type": {
"type": "object",
"properties": {
"recurring": {
"type": "object",
"properties": {
"recurringFrequency": {
"type": "integer",
"minimum": 1,
"maximum": 9999,
"description": "Indicates the minimum number of days between recurring authorizations."
},
"recurringStartDate": {
"type": "string",
"format": "full-date",
"description": "YYYY-MM-DD"
},
"recurringExpiryDate": {
"type": "string",
"format": "full-date",
"description": "Date of subscription expiry in format YYYY-MM-DD. Use 9999-12-31 if not specified."
}
},
"required": [
"recurringExpiryDate",
"recurringFrequency"
],
"additionalProperties": false
},
"unscheduled": {
"type": "string",
"enum": [
"CIT",
"MIT"
],
"description": "CIT: Customer initiated transactions; MIT: Merchant initiated transactions."
}
},
"oneOf": [
{
"required": [
"recurring"
]
},
{
"required": [
"installments"
]
},
{
"required": [
"unscheduled"
]
}
],
"additionalProperties": false
},
"initialPayment": {
"type": "boolean"
},
"useCase": {
"type": "string",
"enum" : ["cof", "ucof", "fixed"],
"description": "Type of useCase (unscheduled: cof, ucof // recurring: fixed)"
}
},
"required": [
"type",
"initialPayment"
],
"additionalProperties": false
}
Sample Recurring
{
"type": {
"recurring": {
"recurringFrequency": 30,
"recurringStartDate": "2019-09-14",
"recurringExpiryDate": "2020-09-14"
}
},
"initialPayment": true,
"useCase": "fixed"
}
Sample Unscheduled CIT
{
"type": {
"unscheduled": "CIT"
},
"initialPayment": true,
"useCase": "ucof"
}
Or previous implementation
{
"type": {
"unscheduled": "CIT"
},
"initialPayment": true
}