Activate Payment Card

The Activate Payment Card endpoint restores a suspended payment card to active status, enabling it to be used again for transactions and payment activities. This endpoint is intended exclusively for cards that have been suspended — it does not activate newly issued cards. Once successfully reactivated, the card behaves like any other active card on the account.

Endpoint

POST /api/paymentCards/activatePaymentCard

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when a cardholder's payment card has been placed in a suspended state and needs to be restored. Common scenarios include lifting a temporary freeze placed by the customer, reversing an administrative suspension after a review, or reactivating a card that was paused due to suspected fraud that has since been resolved. Only suspended cards can be activated through this endpoint — cards in other states (e.g., closed, expired) are not eligible.

Request Body

The request body accepts a paymentCardId as the required base field. Depending on context, additional optional fields may be included.

{
  "paymentCardId": "card_01HXYZ1234ABCDEF567890"
}

Response

200 OK

{
  "paymentCard": {
    "id": "card_01HXYZ1234ABCDEF567890",
    "last4": "4242",
    "bin": "411111",
    "status": "ACTIVE",
    "formFactor": "PHYSICAL",
    "network": "VISA",
    "expirationDate": "2027-06-30T00:00:00Z",
    "subProfileId": null,
    "name": "Business Travel Card",
    "errors": []
  },
  "mutationResult": {
    "errors": []
  }
}

Error Codes

Common Mistakes

• Attempting to activate a card that is not in a SUSPENDED state — this endpoint only works on suspended cards; cards in CLOSED or EXPIRED states cannot be reactivated.
• Omitting paymentCardId from the request body — this field is required and the request will fail without it.
• Using an expired or invalid Bearer token — tokens have a 10-minute lifetime and must be refreshed via POST /api/auth/refresh before expiry.
• Confusing card activation (for newly issued cards) with card reactivation (for suspended cards) — this endpoint is for reactivation only.

Related Endpoints

• POST /api/paymentCards/suspendPaymentCard — Suspends an active payment card, which can later be reactivated using this endpoint.
• POST /api/paymentCards/closePaymentCard — Permanently closes a payment card; closed cards cannot be reactivated.
• POST /api/paymentCards/getPaymentCards — Retrieves a list of payment cards for a customer, including their current status.
• POST /api/paymentCards/issuePaymentCard — Issues a new payment card for a customer or subprofile.

Example

curl -X POST https://api.banking.netevia.dev/api/paymentCards/activatePaymentCard \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentCardId": "card_01HXYZ1234ABCDEF567890"
  }'