Physical cards

Create the card

Create a card with "type": "physical". It stays pending.

Order production and delivery

curl https://api.pointzero.io/v1/cards/card_01JZ8N2K4M/physical-order \
  -H "Authorization: Bearer $POINTZERO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "shipping_method": "standard",
    "shipping_address": {
      "line1": "Calle de Colón 1",
      "city": "Valencia",
      "postal_code": "46004",
      "country": "ES"
    }
  }'

Track the order

Retrieve the order to get its status, carrier and tracking_number.

Order status	Meaning
`pending`	Received. Can still be cancelled.
`processing`	In production.
`shipped`	Handed to the carrier.
`delivered`	Delivered.
`cancelled`	Cancelled before production.

PINs are never sent or stored in plain text. To set a PIN, build an ISO 9564 format 4 PIN block, encrypt it with the PIN key issued to your account and send it as encrypted_pin_block to Set PIN. After too many wrong attempts the PIN status becomes blocked. Call Unblock PIN after verifying the cardholder.

Get Started

API Basics

Card Issuing

PIN

​PIN

PIN