7x Developer Portal & API Documentation

Stores a new tokenized payment card for the authenticated user's wallet. Supports marking the card as default and saving user-friendly nickname metadata.

Request builder

POST

/api/v1/Payments/addcard

Access Token

api-versionstring

*object

sourcestring

maskedPanstring

expirystring

cardholderNamestring

cvvstring

schemestring

cardTokenstring

isDefaultboolean

cardNickNamestring

Reference details

Authorization

OAuth2

AuthorizationBearer <token>

In: header

Query Parameters

api-version?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/Payments/addcard" \  -H "Content-Type: application/json" \  -d '{}'

{  "message": "string",  "payload": {    "maskedPan": "string",    "expiry": "string",    "cardholderName": "string",    "scheme": "string",    "cardToken": "string",    "cvv": "string",    "isDefault": true,    "cardNickName": "string"  },  "responseCode": "Continue",  "errorDetails": {    "property1": null,    "property2": null  }}

{  "message": "string",  "payload": null,  "responseCode": "Continue",  "errorDetails": {    "property1": null,    "property2": null  }}

{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "instance": "string",  "property1": null,  "property2": null}

{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "instance": "string",  "property1": null,  "property2": null}

Overview

Stores a new tokenized payment card for the authenticated user's wallet. Supports marking the card as default and saving user-friendly nickname metadata.

Request builder

POST

/api/v1/Payments/addcard

Access Token

api-versionstring

*object

sourcestring

maskedPanstring

expirystring

cardholderNamestring

cvvstring

schemestring

cardTokenstring

isDefaultboolean

cardNickNamestring

Reference details

Authorization

OAuth2

AuthorizationBearer <token>

In: header

Query Parameters

api-version?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

source?Source

Value in

"Web"
"Mobile"

maskedPan?string

expiry?string

cardholderName?string

cvv?string

scheme?string

cardToken?string

isDefault?boolean

cardNickName?string

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/Payments/addcard" \  -H "Content-Type: application/json" \  -d '{}'

{  "message": "string",  "payload": {    "maskedPan": "string",    "expiry": "string",    "cardholderName": "string",    "scheme": "string",    "cardToken": "string",    "cvv": "string",    "isDefault": true,    "cardNickName": "string"  },  "responseCode": "Continue",  "errorDetails": {    "property1": null,    "property2": null  }}

{  "message": "string",  "payload": null,  "responseCode": "Continue",  "errorDetails": {    "property1": null,    "property2": null  }}

{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "instance": "string",  "property1": null,  "property2": null}

{  "type": "string",  "title": "string",  "status": 0,  "detail": "string",  "instance": "string",  "property1": null,  "property2": null}

source?Source

Value in

"Web"
"Mobile"

maskedPan?string

expiry?string

cardholderName?string

cvv?string

scheme?string

cardToken?string

isDefault?boolean

cardNickName?string

200application/json

400application/json

404application/json

500application/json

200application/json

400application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`