Request Physical Payment Card via Partner

This endpoint enables partners to request the issuance of a new physical (plastic) payment card on behalf of a customer. It collects delivery details, shipping preferences, and card product configuration to initiate card fulfillment. The endpoint ensures secure handling of card-related data while streamlining the physical card ordering process.

Endpoint

POST /api/paymentCards/v2/openPartnerCardPhysical

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 partner needs to order a physical payment card to be mailed to a customer's address. This is appropriate for onboarding flows where a customer has been approved and requires a physical card tied to a specific card product. It supports various shipping methods to accommodate standard and expedited delivery requirements.

Request Body

{
  "deliveryDetails": {
    "name": {
      "givenName": "Jane",
      "familyName": "Smith"
    },
    "companyName": "Acme Corp",
    "address": {
      "streetAddress": "123 Main St",
      "extendedAddress": "Suite 400",
      "postalCode": "30301",
      "region": "GA",
      "locality": "Atlanta",
      "countryCodeAlpha3": "USA"
    }
  },
  "courier": {
    "method": "UPS_GROUND"
  },
  "cardProductId": "prod_abc123xyz",
  "cardProfileSetId": "profileset_001",
  "paymentCardName": "Business Debit"
}

Response

200 OK

{
  "id": 4821,
  "createdDate": "2026-06-08T14:32:00Z",
  "updatedDate": null,
  "cardProductId": "prod_abc123xyz",
  "userProfileId": 10045,
  "isVirtual": false,
  "success": true,
  "errors": null,
  "paymentCardShippingMethod": "UPS_GROUND",
  "streetAddress": "123 Main St",
  "postalCode": "30301",
  "region": "GA",
  "locality": "Atlanta",
  "countryCodeAlpha3": "USA",
  "givenName": "Jane",
  "familyName": "Smith",
  "companyName": "Acme Corp",
  "onlyFinancialAccount": false,
  "extendedAddress": "Suite 400",
  "cardProfileSetId": "profileset_001",
  "paymentCardName": "Business Debit",
  "subUserId": null
}

Error Codes

Common Mistakes

• Providing a postalCode that is not exactly 5 digits — the field enforces a strict ^\d{5}$ pattern; ZIP+4 format (e.g., "30301-1234") will be rejected.
• Providing a region that is not exactly 2 characters — full state names (e.g., "Georgia") are invalid; use the 2-letter code (e.g., "GA").
• Providing a countryCodeAlpha3 that is not exactly 3 characters — use ISO 3166-1 alpha-3 codes (e.g., "USA") not alpha-2 (e.g., "US").
• Omitting deliveryDetails.companyName — this field is required even for individual (non-business) card orders.
• Using a streetAddress that begins with a non-numeric character — the field requires a leading street number (e.g., "123 Main St", not "Main St 123").

Related Endpoints

• POST /api/paymentCards/v2/openPartnerCardVirtual — Issue a virtual payment card through a partner
• POST /api/paymentCards/v2/openPartnerCardBurner — Issue a temporary burner card through a partner
• GET /api/paymentCards/v2 — List payment cards for the authenticated user
• POST /api/auth/v2 — Obtain a Bearer token for authentication

Example

curl -X POST https://api.banking.netevia.dev/api/paymentCards/v2/openPartnerCardPhysical \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryDetails": {
      "name": {
        "givenName": "Jane",
        "familyName": "Smith"
      },
      "companyName": "Acme Corp",
      "address": {
        "streetAddress": "123 Main St",
        "extendedAddress": "Suite 400",
        "postalCode": "30301",
        "region": "GA",
        "locality": "Atlanta",
        "countryCodeAlpha3": "USA"
      }
    },
    "courier": {
      "method": "UPS_GROUND"
    },
    "cardProductId": "prod_abc123xyz",
    "cardProfileSetId": "profileset_001",
    "paymentCardName": "Business Debit"
  }'