Add Payment
Add a new payment method to a user by ID
Endpoint Details
POST
/users/payments/add
Headers
Content-Type
application/json
Authorization
Bearer <YOUR_ACCESS_TOKEN>
Body
userId
string
Identifier of the user to add payment method for
paymentMethodId
string
Payment method ID or new payment token, you must use the CLOUD SDK to mount/inject a paymentElement to be able to generate a payment token.
isDefault
boolean
Set as default payment method (default: false)
Response Details
statusCode
number
HTTP status code of the response
message
string
A brief message describing the result of the API call
Metadata Object
languages
Array<string>
List of supported languages for the response, e.g. ["en"]
timestamp
string
Unix timestamp (in milliseconds) when the response was generated
timezone
string
Timezone used for the response, always "UTC"
requestId
string
Unique identifier for the API request. Used for debugging and support
path
string
API path
version
string
API version used for the request
Sample Request and Response
curl --location 'https://staging.api.liquidcommerce.cloud/users/payments/add' \
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"customerId": "usrid_123abc456def",
"paymentMethodId": "paymentid_123abc456def",
"isDefault": true
}'
{
"statusCode": 201,
"message": "Adding an new payment method succeeded",
"metadata": {
"languages": [
"en"
],
"timestamp": 1731625068720,
"timezone": "UTC",
"requestId": "requestid_123abc456def",
"path": "/api/users/payments/add",
"version": "1.7.0"
},
"data": {
"id": "paymentid_123abc456def",
"type": "card",
"isDefault": true,
"card": {
"brand": "visa",
"country": "US",
"expMonth": 11,
"expYear": 2031,
"last4": "1111",
"funding": "credit"
},
"createdAt": "2024-11-14T22:57:49.094Z"
}
}
Last updated