Change Subscription Primary Card

This API allows you to change the primary card associated with a specific subscription identified by {{subscription_id}}. To use this functionality, send a PUT request to the provided URL with the relevant Bearer Token in the request header and specify the new primary card by including its card identifier in the request payload. This API is useful for managing the payment method for a subscription.

Change Subscription Primary Card Request:

URL: https://accept.paymob.com/api/acceptance/subscriptions/{{subscription_id}}/change-primary-card

Method: POST

Source: Merchant's server

Recipient: Accept's server

Authentication: Bearer Token {auth token}

Content-Type: JSON

ParameterDescriptionMandatory
cardThe card identifier “TOKEN” to set as the new primary card.
You will have to pass a correct card ID which needs to be changed as Primary card. You will get the list of cards against one specific subscription id through List Subscription Cards API.
Yes

Example request data:

{
    "card": 4 //to delete specific card from any subscription id, first check the list 
  //of subscription cards and then run this IP by selecting correct card id.Every card has its own id.
}

Example response data:

{
    "id": 6,
    "created_at": "2023-12-05T19:14:56.789179",
    "is_primary": true,
    "masked_pan": "xxxx-xxxx-xxxx-1111",
    "failed_attempts": 0
}