Update Subscription Payment Method
The PUT /api/v1.3/subscription/{subscriptionId}/update-payment-method method is used to update the subscription's payment method.
The subscriptionId must be included as part of the URL path.
ENDPOINTS
| Name | URL |
|---|---|
| Sandbox | https://pci-gw-test.praxispay.com/api/v1.3/subscription/{subscriptionId}/update-payment-method |
| Live | https://gw.praxisgate.com/api/v1.3/subscription/{subscriptionId}/update-payment-method |
REQUEST PARAMS
✓ - required value
? - optional, value or null
✕ - always appears as null
| Variable | Type | Description | |
|---|---|---|---|
| merchant_id | varchar(50) | ✓ | Merchant API client account identifier |
| application_key | varchar(32) | ✓ | Identifier of your application (website) |
| card_token | varchar(32) | ✓ | Customer card token |
| version | varchar(4) | ✓ | API version. Default value - v1.3 |
| timestamp | int(11) | ✓ | Response time (unix timestamp, seconds) |
RESPONSE PARAMS
| Variable | Type | Description | |
|---|---|---|---|
| status | int | ✓ | API communication status - - 0 if the request was successful - Negative integer if internal server/network error occurs - Positive integer if application/logical error occurs |
| description | varchar(256) | ✓ | Accurate description of the result. Return the actual error for any exception as it helps to diagnose issues in production. |
| subscription_id | varchar(32) | ✓ | Subscription ID |
| card_token | varchar(32) | ✓ | Customer card token |
| subscription_status | varchar(8) | ✓ | Status of subscription |
| version | varchar(3) | ✓ | API version |
| timestamp | int(11) | ✓ | Response time (unix timestamp, seconds) |
Signature
To execute the request, it is necessary to undergo the authentication process. The general authentication algorithm can be found in the Authentication section.
Request signature parameters
merchant_idapplication_keytimestamp
Response signature parameters
statustimestamp
Example
Request
{
"merchant_id": "API-Merchant",
"application_key": "test-application",
"card_token": "a52028efb6ccbedd65c066ce284c7dfb",
"version": 1.3,
"timestamp": 1680712861
}Response (successful scenario)
{
"status": 0,
"description": "Payment method successfully updated",
"subscription_id": "tvoS9vGKdDwfGLLvp0r8JJ5d",
"card_token": "a52028efb6ccbedd65c066ce284c7dfb",
"subscription_status": "active",
"version": 1.3,
"timestamp": 1680712861
}Response (unsuccessful scenario)
{
"status": -1,
"description": "Subscription with ID tvoS9vGKdDwfGLLvp0r8JJ5d for customer user-1234 not found",
"version": 1.3,
"timestamp": 1680712861
}