Retrieve detailed status and delivery information for a physical payment card order.
Get Physical Card Order Info
The Get Physical Card Order Info endpoint retrieves detailed information about an order for a physical payment card. It provides real-time updates on the order's progress, including card production status and delivery details. Partners can use this endpoint to help customers track their card from issuance through delivery.
Endpoint
GET /api/paymentCards/findPhysicalPaymentCardOrder
Authentication
Bearer token required. Obtain via:
POST https://api.banking.netevia.dev/api/auth/v2Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.
When to use
Use this endpoint when a customer wants to check the current status of a physical card they have ordered. It is useful for customer support workflows, order confirmation flows, and tracking UIs where partners need to display card production and shipping progress to end users.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| OrderId | string | Yes | The unique identifier of the physical card order to look up. |
| PaymentCardId | string | Yes | The unique identifier of the payment card associated with the order. |
Response
200 OK
| Field | Type | Description |
|---|---|---|
| orderId | string | Unique identifier of the card order. |
| paymentCardId | string | Unique identifier of the associated payment card. |
| status | string | Current status of the card order (e.g., PENDING, IN_PRODUCTION, SHIPPED, DELIVERED). |
| trackingNumber | string | Shipping carrier tracking number, if available. |
| carrier | string | Name of the shipping carrier handling delivery. |
| estimatedDeliveryDate | string | Estimated date the card will be delivered (ISO 8601 format). |
| shippingAddress | object | Destination address for the card shipment. |
| shippingAddress.line1 | string | Street address line 1. |
| shippingAddress.line2 | string | Street address line 2 (optional). |
| shippingAddress.city | string | City. |
| shippingAddress.state | string | State or region code. |
| shippingAddress.postalCode | string | Postal/ZIP code. |
| shippingAddress.country | string | Country code (ISO 3166-1 alpha-2). |
| createdAt | string | Timestamp when the order was created (ISO 8601 format). |
| updatedAt | string | Timestamp when the order was last updated (ISO 8601 format). |
{
"orderId": "ORD-20240601-00123",
"paymentCardId": "CARD-98765",
"status": "SHIPPED",
"trackingNumber": "1Z999AA10123456784",
"carrier": "UPS",
"estimatedDeliveryDate": "2024-06-10",
"shippingAddress": {
"line1": "123 Main Street",
"line2": "Suite 400",
"city": "Miami",
"state": "FL",
"postalCode": "33101",
"country": "US"
},
"createdAt": "2024-06-01T10:00:00Z",
"updatedAt": "2024-06-03T14:30:00Z"
}Error Codes
| Code | When it happens |
|---|---|
| 400 | OrderId or PaymentCardId is missing, empty, or malformed. |
| 401 | Token missing, expired, or invalid. |
| 403 | Insufficient permissions to access this card order. |
| 404 | No order found matching the provided OrderId and PaymentCardId. |
| 500 | Internal server error. |
Common Mistakes
- Providing an
OrderIdthat does not correspond to thePaymentCardIdsupplied — both parameters must match the same order record. - Omitting either required query parameter; both
OrderIdandPaymentCardIdare required for a valid request. - Using a virtual or burner card ID in
PaymentCardId— this endpoint is specific to physical card orders only.
Related Endpoints
POST /api/paymentCards/orderPhysicalPaymentCard— Place a new physical card order for a customer.GET /api/paymentCards/getPaymentCard— Retrieve general details about a payment card.POST /api/paymentCards/activatePhysicalPaymentCard— Activate a physical card once it has been received.
Example
curl -X GET "https://api.banking.netevia.dev/api/paymentCards/findPhysicalPaymentCardOrder?OrderId=ORD-20240601-00123&PaymentCardId=CARD-98765" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"Success