POST
issuing
/
cards
Crear tarjetas
curl --request POST \
  --url https://api.onepay.la/v1/issuing/cards \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency: <x-idempotency>' \
  --data '{
  "customer_id": "<string>",
  "wallet_id": "<string>",
  "nickname": "<string>",
  "type": "<string>",
  "address": {
    "line_1": "<string>",
    "line_2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "country": "<string>",
    "zip_code": "<string>"
  }
}'
{
  "id": "9e4298cb-ad7b-40f0-929d-a68e20a561c9",
  "status": "created",
  "last_4": null,
  "nickname": null,
  "type": "physical",
  "customer_id": "9e4298cb-a9a4-476d-8c7d-287c0f1e103b",
  "wallet_id": "0195255e-3258-707e-bfaf-3f6807d12d60",
  "customer": {
    "id": "9e4298cb-a9a4-476d-8c7d-287c0f1e103b",
    "first_name": "Rossie",
    "last_name": "Rempel",
    "email": "",
    "phone": "+12259504339",
    "document_type": "CC",
    "document_number": "72827",
    "created_at": "2025-02-20T21:58:05.000000Z",
    "is_test": true
  },
  "address": {
    "line_1": "125 Novella Turnpike",
    "line_2": "40003 Lang Circle Suite 752",
    "state": "Boylefurt",
    "city": "Port Alessiaton",
    "country": "Zambia"
  },
  "wallet": {
    "id": "0195255e-3258-707e-bfaf-3f6807d12d60",
    "balance": 0,
    "label": "$0"
  }
}

​
Headers

​
x-idempotency
string
required
Token único para garantizar la idempotencia de la petición

​
Body

​
customer_id
string
required
ID del cliente al que se le asignará la tarjeta.
​
wallet_id
string
required
ID de la billetera al que se le asignará la tarjeta.
​
nickname
string
Apodo para la tarjeta.
​
type
string
required
Tipo de tarjeta.
​
address
object
required
Dirección de envío de la tarjeta.
{
  "id": "9e4298cb-ad7b-40f0-929d-a68e20a561c9",
  "status": "created",
  "last_4": null,
  "nickname": null,
  "type": "physical",
  "customer_id": "9e4298cb-a9a4-476d-8c7d-287c0f1e103b",
  "wallet_id": "0195255e-3258-707e-bfaf-3f6807d12d60",
  "customer": {
    "id": "9e4298cb-a9a4-476d-8c7d-287c0f1e103b",
    "first_name": "Rossie",
    "last_name": "Rempel",
    "email": "",
    "phone": "+12259504339",
    "document_type": "CC",
    "document_number": "72827",
    "created_at": "2025-02-20T21:58:05.000000Z",
    "is_test": true
  },
  "address": {
    "line_1": "125 Novella Turnpike",
    "line_2": "40003 Lang Circle Suite 752",
    "state": "Boylefurt",
    "city": "Port Alessiaton",
    "country": "Zambia"
  },
  "wallet": {
    "id": "0195255e-3258-707e-bfaf-3f6807d12d60",
    "balance": 0,
    "label": "$0"
  }
}