Get Paid Shipping Options
Returns a dictionary of available paid shipping delivery methods and their corresponding costs. This endpoint is used when ordering physical payment cards that require expedited or premium shipping. Each entry in the response maps a delivery option name to its cost in the smallest currency unit (e.g., cents).
Endpoint
GET /api/paymentCards/paidShipping
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 before placing a physical card order when you need to present paid shipping upgrade options to the customer. Call this endpoint to populate a shipping selection UI so the customer can choose a preferred delivery speed and see its cost before confirming the card issuance request.
Response
200 OK
The response is a JSON object where each key is a shipping delivery option name (string) and each value is the cost of that option as an integer (int64), expressed in the smallest currency unit (cents).
| Field | Type | Description |
|---|---|---|
{deliveryOptionName} | integer (int64) | Cost of the named shipping option in cents (e.g., 500 = $5.00) |
{
"Standard": 0,
"Expedited": 500,
"Overnight": 1500
}Error Codes
| Code | When it happens |
|---|---|
| 401 | Token missing, expired, or invalid |
| 403 | Insufficient permissions |
| 500 | Internal server error |
Common Mistakes
- Interpreting the cost values as dollars rather than cents — divide by 100 to display a dollar amount to end users.
- Assuming a fixed set of shipping option names — the keys are dynamic and may vary; always render them from the response rather than hardcoding labels.
Related Endpoints
POST /api/paymentCards— Issue a new physical payment card, where a paid shipping option can be specifiedGET /api/paymentCards— Retrieve a list of existing payment cards for a customer
Example
curl -X GET https://api.banking.netevia.dev/api/paymentCards/paidShipping \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"