v1

latestOpenAPI 3.1.02026-07-245178279.0 KB
Tarjetas

Crear Tarjeta

Crear una o más tarjetas para un usuario previamente creado

post/v2/users/{user_id}/cards

Request body

address1string

Dirección del tarjetahabiente

card_cvvstring required

Código de validación de la tarjeta

card_holderstring required

Nombre del tarjetahabiente

card_holder_dnistring required

Número de identificación del tarjetahabiente

card_numberstring required

Número de la tarjeta

citystring

Ciudad de la dirección del tarjetahabiente

countrystring

País de la dirección del tarjetahabiente

credential_source'apple_pay' | 'google_pay' | 'click_to_pay'

Origin of the card used to process the payment. Indicates the wallet through which the transaction is made.

expiry_monthstring required

Mes de expiración de la tarjeta en 2 dígitos (formato MM).

expiry_yearstring required

Año de expiración de la tarjeta en 4 dígitos (formato YYYY).

is_defaultboolean

Indicador de tarjeta por defecto

phonestring

Número de teléfono del tarjetahabiente

statestring

Estado de la dirección del tarjetahabiente

zipstring

Código postal de la dirección del tarjetahabiente

Example request

[
  {
    "address1": "Av. de los Incas 0329",
    "card_cvv": "123",
    "card_holder": "Jhon Doe",
    "card_holder_dni": "123456789",
    "card_number": "4242424242424242",
    "city": "Ambato ",
    "country": "Ecuador",
    "credential_source": "google_pay",
    "credential_source_config": {
      "type": "google_pay",
      "values": {
        "encrypted_data": "{\"signature\":\"MEQCIB...\",\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{...}\"}",
        "encryption_header": {
          "ephemeral_public_key": "MFkwEw...",
          "public_key_hash": "EB8/Sy...",
          "signature": "MIAGCSqG..."
        },
        "merchant_transaction_id": "0a4e0d3...",
        "src_cx_flow_id": "mobile",
        "system": "DIRECT"
      }
    },
    "expiry_month": "11",
    "expiry_year": "2039",
    "is_default": true,
    "phone": "12345755",
    "state": "Ambato",
    "zip": "180202"
  }
]

Response

Created

card_brand'mastercard' | 'visa' | 'amex' | 'diners' | 'jcb' | 'alia' | 'carnet' | 'codensa' | 'elo' | 'serfinanza' | 'privada' | 'unionpay' | 'aurea' | 'cartesbancaires' | 'bancontact' | 'girocard' | 'hipercard' | 'naranja' | 'cabal' | 'argencard' | 'cordobesa' | 'eftpos'

Standardized card brand.

card_holderstring required

Nombre del tarjetahabiente

card_holder_dnistring required

Número de identificación del tarjetahabiente

card_type'credit_card' | 'debit_card'

Tipo de tarjeta

companystring

Compañía que emite la tarjeta

created_atstring

Fecha en que fue creada la tarjeta(UTC), información interna DEUNA

deleted_atstring

Fecha en que fue eliminada la tarjeta(UTC), información interna DEUNA

expiration_datestring

Fecha de expiración de la tarjeta

first_sixstring

Primeros 6 dígitos de la tarjeta

idstring

Identificador único de la tarjeta creado por DEUNA y se utiliza en el proceso de /purchase API

is_defaultboolean

Indicador de tarjeta por defecto

last_fourstring

Últimos 4 dígitos de la tarjeta

last_usedstring

Fecha de la última compra realizada con la tarjeta(UTC)

updated_atstring

Fecha de modificacion de la tarjeta(UTC), información interna DEUNA

user_idstring

Identificador del usuario

Example response

[
  {
    "is_default": true
  }
]