Update Payment Token Details
PATCH/payment-tokens/{payment-token-id}
For cards, allows updating cardholder name and expiration of the token. Can link to a buyer as well.
Request
Path Parameters
Represents a customer bank account in the Nuvei system.
- application/json
Body
required
Processing entityId
provided by Nuvei.
80aef199-b89a-4d59-ba0c-f2cd3c25d5cd
paymentOption
object
card
object
The cardholder name.
Possible values: <= 70 characters
Jada Pinkett
The card expiration month.
Possible values: >= 2 characters
and <= 2 characters
, Value must match regular expression ^(0[1-9]|1[0-2])$
06
The card expiration year.
Possible values: >= 2 characters
and <= 4 characters
, Value must match regular expression ^(\d{4}|\d{2})$
2022
alternativePaymentMethod
object
data
object
Merchant Reference for a business entity (token, subscription, etc.)
Possible values: <= 50 characters
MREF_6f06168d-ff6e-448b-8401-30051eb6b1af
Possible values: [recurring
, unscheduled
]
Responses
- 200
- 400
- 401
- 403
- 404
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
result
object
required
Possible values: [success
, error
]
errors
object
If an error occurred on the request side, an error code is returned in this parameter.
Possible values: <= 11 characters
7000.1000
If an error occurred on the request side, then an error reason is returned in this parameter.
Possible values: <= 400 characters
Unexpected error
{
"result": {
"status": "success",
"errors": {
"code": "7000.1000",
"reason": "Unexpected error"
}
}
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
result
object
required
Possible values: [success
, error
]
errors
object
If an error occurred on the request side, an error code is returned in this parameter.
Possible values: <= 11 characters
7000.1000
If an error occurred on the request side, then an error reason is returned in this parameter.
Possible values: <= 400 characters
Unexpected error
{
"result": {
"status": "success",
"errors": {
"code": "7000.1000",
"reason": "Unexpected error"
}
}
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
result
object
required
Possible values: [success
, error
]
errors
object
If an error occurred on the request side, an error code is returned in this parameter.
Possible values: <= 11 characters
7000.1000
If an error occurred on the request side, then an error reason is returned in this parameter.
Possible values: <= 400 characters
Unexpected error
{
"result": {
"status": "success",
"errors": {
"code": "7000.1000",
"reason": "Unexpected error"
}
}
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
result
object
required
Possible values: [success
, error
]
errors
object
If an error occurred on the request side, an error code is returned in this parameter.
Possible values: <= 11 characters
7000.1000
If an error occurred on the request side, then an error reason is returned in this parameter.
Possible values: <= 400 characters
Unexpected error
{
"result": {
"status": "success",
"errors": {
"code": "7000.1000",
"reason": "Unexpected error"
}
}
}
Not Found
- application/json
- Schema
- Example (from schema)
Schema
result
object
required
Possible values: [success
, error
]
errors
object
If an error occurred on the request side, an error code is returned in this parameter.
Possible values: <= 11 characters
7000.1000
If an error occurred on the request side, then an error reason is returned in this parameter.
Possible values: <= 400 characters
Unexpected error
{
"result": {
"status": "success",
"errors": {
"code": "7000.1000",
"reason": "Unexpected error"
}
}
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
result
object
required
Possible values: [success
, error
]
errors
object
If an error occurred on the request side, an error code is returned in this parameter.
Possible values: <= 11 characters
7000.1000
If an error occurred on the request side, then an error reason is returned in this parameter.
Possible values: <= 400 characters
Unexpected error
{
"result": {
"status": "success",
"errors": {
"code": "7000.1000",
"reason": "Unexpected error"
}
}
}