Resend Physical card

Resend Physical Card

This endpoint allows partners to resend a physical payment card to a customer. Use it when a card has been lost, damaged, or never received. A new physical card will be produced and shipped to the address provided in the request.

Endpoint

POST /api/paymentCards/resendPhysicalCard

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 customer reports that their physical card was lost, stolen, or not delivered. It replaces the existing card and ships a new one to the address you specify. You can optionally choose a courier method to control delivery speed.

Request Body

{
  "paymentCardId": "card_abc123xyz456",
  "deliveryDetails": {
    "name": {
      "givenName": "Jane",
      "familyName": "Smith"
    },
    "companyName": "Acme Corp",
    "address": {
      "streetAddress": "456 Commerce Blvd",
      "extendedAddress": "Suite 200",
      "postalCode": "30301",
      "region": "GA",
      "locality": "Atlanta",
      "countryCodeAlpha3": "USA"
    }
  },
  "courier": {
    "method": "UPS_NEXT_DAY"
  }
}

Response

200 OK

A 200 status indicates the resend request was successfully submitted. The card will be produced and shipped to the address provided. The response body on success is empty or a standard success acknowledgment.

{}

Error Codes

Common Mistakes

• Providing a postalCode that is not exactly 5 digits — the field requires the pattern ^\d{5}$
• Using a 2-letter country code (e.g., "US") instead of the required 3-letter ISO alpha-3 code (e.g., "USA")
• Setting region to a value other than the 2-letter state abbreviation — it must be exactly 2 characters
• Omitting deliveryDetails, deliveryDetails.name, deliveryDetails.companyName, or deliveryDetails.address, all of which are required
• Formatting streetAddress incorrectly — it must start with a numeric street number followed by the street name

Related Endpoints

• POST /api/paymentCards/orderPhysicalCard — Order a new physical payment card for a customer
• POST /api/paymentCards/activateCard — Activate a physical card after it has been received
• GET /api/paymentCards/{paymentCardId} — Retrieve details about a specific payment card

Example

curl -X POST https://api.banking.netevia.dev/api/paymentCards/resendPhysicalCard \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentCardId": "card_abc123xyz456",
    "deliveryDetails": {
      "name": {
        "givenName": "Jane",
        "familyName": "Smith"
      },
      "companyName": "Acme Corp",
      "address": {
        "streetAddress": "456 Commerce Blvd",
        "extendedAddress": "Suite 200",
        "postalCode": "30301",
        "region": "GA",
        "locality": "Atlanta",
        "countryCodeAlpha3": "USA"
      }
    },
    "courier": {
      "method": "UPS_NEXT_DAY"
    }
  }'