Reissue Payment Card

This endpoint reissues a replacement payment card for an existing customer profile. It is used when a card has been lost, stolen, damaged, or expired and a new card needs to be issued in its place. The reissued card can be physical or virtual, and existing spending limits from the original card can optionally be carried over.

Endpoint

POST /netevia/paymentCard/reissue

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 reports their card as lost, stolen, or damaged, or when a card has expired and needs replacement. It is also appropriate when migrating a customer to a new card profile while preserving their existing configuration. If spending controls were configured on the original card, set keepSpendingLimits to true to avoid reconfiguring them on the new card.

Request Body

{
  "profileId": 10045,
  "paymentCardId": "pc_9a3f2c1b4d7e6f08",
  "last4": "7823",
  "physical": true,
  "activateNow": false,
  "reason": "lost",
  "keepSpendingLimits": true,
  "paymentCardName": "Business Debit Card",
  "shipping": "standard",
  "financialAccount": "fa_4b2e9d1c7a0f5e33",
  "cardProfileSetId": "cps_1d4f8a2c9b3e7f50",
  "cardDeliveryDetails": {
    "name": {
      "givenName": "Jane",
      "familyName": "Smith"
    },
    "companyName": "Acme Corp",
    "address": {
      "streetAddress": "123 Main St",
      "extendedAddress": "Suite 400",
      "locality": "Austin",
      "region": "TX",
      "postalCode": "78701",
      "countryCodeAlpha3": "USA"
    }
  }
}

Response

200 OK

The response returns one of two schemas depending on whether a new financial account was opened as part of the reissue process.

boardingresponse (standard reissue):

openfinancialaccountresponse (reissue with new financial account):

Inherits all fields from boardingresponse, plus:

{
  "profileId": 10045,
  "success": true,
  "errors": null,
  "changeLog": [
    {
      "requestType": 7,
      "changes": "Payment card reissued successfully; spending limits transferred from previous card."
    }
  ]
}

Error Codes

Common Mistakes

• Providing a region value that is not exactly 2 characters or a postalCode that is not exactly 5 digits will cause a 400 validation error.
• Omitting cardDeliveryDetails when physical is true will result in a failed request, as delivery information is required to ship a physical card.
• Using a countryCodeAlpha3 value with fewer or more than 3 characters (e.g., passing "US" instead of "USA") will fail schema validation.
• Setting keepSpendingLimits to false when you intend to preserve controls will silently reset all spending limits on the replacement card.
• The last4 field is for identification purposes only; it does not replace the requirement to supply paymentCardId when you have it available.

Related Endpoints

• POST /netevia/paymentCard/issue — Issue a new payment card for a customer profile
• POST /netevia/paymentCard/activate — Activate a newly issued or reissued payment card
• POST /netevia/paymentCard/cancel — Cancel an existing payment card
• GET /netevia/paymentCard — Retrieve payment card details for a profile

Example

curl -X POST https://api.banking.netevia.dev/netevia/paymentCard/reissue \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": 10045,
    "paymentCardId": "pc_9a3f2c1b4d7e6f08",
    "last4": "7823",
    "physical": true,
    "activateNow": false,
    "reason": "lost",
    "keepSpendingLimits": true,
    "paymentCardName": "Business Debit Card",
    "shipping": "standard",
    "financialAccount": "fa_4b2e9d1c7a0f5e33",
    "cardDeliveryDetails": {
      "name": {
        "givenName": "Jane",
        "familyName": "Smith"
      },
      "companyName": "Acme Corp",
      "address": {
        "streetAddress": "123 Main St",
        "extendedAddress": "Suite 400",
        "locality": "Austin",
        "region": "TX",
        "postalCode": "78701",
        "countryCodeAlpha3": "USA"
      }
    }
  }'