Create Physical Card Order

Request

Order a new, physical card for an account. It will be delivered to the specified address.

Security

HTTPBearer

Path

account_idstring, (uuid)(Account Id)required

Headers

x-jiko-idempotencystring, (uuid)(X-Jiko-Idempotency)required

A UUID you generate to identify this request. Reusing a value that was already sent is rejected as a duplicate request.

x-jiko-signaturestring(X-Jiko-Signature)required

Base64-encoded HMAC-SHA256 hash of x-jiko-idempotency + request pathname + body, keyed with your shared secret. See Authentication for the full algorithm and a code sample.

Bodyapplication/jsonrequired

name_on_cardstring, <= 100 characters(Name On Card)required

Card holder's full name. Should be a maximum of 26 characters.

shipping_addressobject(ShippingAddress)required

curl -i -X POST \
  'https://your-partner-name.sandbox-api.jikoservices.com/api/v1/jiko-accounts/{account_id}/card-orders/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string' \
  -d '{
    "name_on_card": "string",
    "shipping_address": {
      "street_address": "string",
      "street_address2": "string",
      "city": "string",
      "postal_code": "string",
      "state": "AA",
      "country": "USA"
    }
  }'

Responses

Successful Response

Bodyapplication/json

card_idstring or null(Card Id)

Any of:

string (uuid)

card_order_idstring, (uuid)(Card Order Id)required

statusstring(Status)required

Enum:"INITIAL""CARD_CREATED""ORDERED""RECEIVED"

name_on_cardstring(Name On Card)required

shipping_addressobject(ShippingAddress)required

object_typestring(Object Type)read-onlyrequired

Response

{
  "card_id": "66f6e46c-f6a1-4af8-a1bd-49666bc01304",
  "card_order_id": "d66e74c4-66f9-4937-8518-1a94f39ba0f9",
  "status": "INITIAL",
  "name_on_card": "Jiko Customer",
  "shipping_address": {
    "street_address": "2000 Allston Way",
    "city": "Berkeley",
    "postal_code": "94701",
    "state": "CA",
    "country": "USA"
  },
  "object_type": "PhysicalCardOrderResponse"
}