Set reissue address

post

https://api.banking.netevia.dev/api/paymentCards/reissue/address/{paymentCardId}

Set Reissue Address

This endpoint sets or updates the delivery address to be used when reissuing a physical payment card. When a card needs to be replaced or reissued, the system will ship the new card to the address provided here. This is applicable to physical (plastic) cards only, as virtual and burner cards do not require a shipping address.

Endpoint

POST /api/paymentCards/reissue/address/{paymentCardId}

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 before triggering a card reissue when the cardholder's delivery address has changed or needs to be specified for the replacement card shipment. This is typically called when a card is reported lost or stolen, or when a card is expiring and the holder has moved. Setting the correct address ensures the reissued card reaches the cardholder without delay.

Path Parameters

Parameter	Type	Required	Description
paymentCardId	string	Yes	The unique identifier of the payment card to set the reissue shipping address for

Request Body

Field	Type	Required	Description
streetAddress	string	Yes	Primary street address line (e.g., house number and street name). Must match pattern: starts with a number followed by street name components
extendedAddress	string	No	Secondary address line for apartment, suite, unit, building, floor, etc.
postalCode	string	Yes	5-digit US ZIP code (pattern: `^\d{5}$`)
region	string	Yes	2-character state or region code (e.g., `FL`, `CA`)
locality	string	Yes	City or locality name
countryCodeAlpha3	string	Yes	3-character ISO 3166-1 alpha-3 country code (e.g., `USA`)

{
  "streetAddress": "123 Main Street",
  "extendedAddress": "Apt 4B",
  "postalCode": "33101",
  "region": "FL",
  "locality": "Miami",
  "countryCodeAlpha3": "USA"
}

Response

200 OK

Field	Type	Description
streetAddress	string	Primary street address line that was saved
extendedAddress	string	Secondary address line that was saved (nullable)
postalCode	string	5-digit ZIP code that was saved (nullable)
locality	string	City or locality that was saved (nullable)
region	string	2-character state or region code that was saved (nullable)
countryCodeAlpha3	string	3-character ISO country code that was saved (nullable)

{
  "streetAddress": "123 Main Street",
  "extendedAddress": "Apt 4B",
  "postalCode": "33101",
  "locality": "Miami",
  "region": "FL",
  "countryCodeAlpha3": "USA"
}

Error Codes

Code	When it happens
400	Missing required fields, invalid postal code format (not 5 digits), invalid region code (not exactly 2 characters), invalid country code (not exactly 3 characters), or street address fails pattern validation
401	Token missing, expired, or invalid
403	Insufficient permissions to update this payment card
404	Payment card with the specified `paymentCardId` not found
500	Internal server error

Common Mistakes

Providing a postal code that is not exactly 5 digits — postalCode must match ^\d{5}$ (US ZIP codes only)
Using a full state name instead of the 2-character abbreviation for region (use FL not Florida)
Providing a 2-character ISO country code instead of the required 3-character alpha-3 code for countryCodeAlpha3 (use USA not US)
Attempting to set a reissue address on a virtual or burner card, which do not support physical shipping
Including special characters in streetAddress that do not match the required pattern — the address must start with a number

Related Endpoints

POST /api/paymentCards/reissue/{paymentCardId} — Trigger the reissue of a payment card after the address has been set
GET /api/paymentCards/{paymentCardId} — Retrieve current payment card details including its status
POST /api/paymentCards — Create a new payment card for a customer

Example

curl -X POST https://api.banking.netevia.dev/api/paymentCards/reissue/address/card_abc123xyz \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "streetAddress": "123 Main Street",
    "extendedAddress": "Apt 4B",
    "postalCode": "33101",
    "region": "FL",
    "locality": "Miami",
    "countryCodeAlpha3": "USA"
  }'

Response

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/json

text/json