Almacena tokens de tarjeta para pagos futuros

POST

token

curl -X POST https://api.therius.io/v1/token \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "shopper": { "id": "customer-42", "email": "ada@example.com" },
    "tokens": [{
      "card": {
        "cardData": {
          "cardNumber": "4111111111111111",
          "cardholderName": "Ada Lovelace",
          "expiryMonth": "12",
          "expiryYear": "2030",
          "cvv": "123"
        }
      }
    }]
  }'

{
  "merchantCode": "MERCHANT_001",
  "shopper": { "id": "customer-42", "email": "ada@example.com" },
  "tokens": [{
    "id": "vt_abc123xyz",
    "card": {
      "cardData": { "brand": "visa", "cardNumber": "411111****1111", "type": "credit" }
    },
    "expirationDate": "2030-12"
  }]
}

POST /token te permite almacenar los datos de tarjeta como tokens reutilizables sin procesar un pago. Úsalo para pre-depositar tarjetas en el vault durante flujos de configuración de cuenta, o para migrar tarjetas almacenadas de otro proveedor. Cada token está limitado a tu cuenta de comercio y se almacena con datos de BIN (bandera, tipo, emisor).

Para tokenizar una tarjeta durante un pago, agrega card.cardData.tokenize: true a tu solicitud de pago en su lugar — ver Conceptos de tokenización.

Cada entrada de tokens[] debe llevar un card con cardData (campos sin procesar — solo entornos del lado del servidor/que cumplen PCI) o nonceData (un nonce generado por el SDK, para flujos de navegador). Una solicitud exitosa devuelve 200 OK con el código de comercio, el shopper devuelto y un objeto de token creado por entrada (id con prefijo vt_, cardData enmascarado, expirationDate, tokenCreationReference) — en el mismo orden que la solicitud.

curl -X POST https://api.therius.io/v1/token \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "shopper": { "id": "customer-42", "email": "ada@example.com" },
    "tokens": [{
      "card": {
        "cardData": {
          "cardNumber": "4111111111111111",
          "cardholderName": "Ada Lovelace",
          "expiryMonth": "12",
          "expiryYear": "2030",
          "cvv": "123"
        }
      }
    }]
  }'

{
  "merchantCode": "MERCHANT_001",
  "shopper": { "id": "customer-42", "email": "ada@example.com" },
  "tokens": [{
    "id": "vt_abc123xyz",
    "card": {
      "cardData": { "brand": "visa", "cardNumber": "411111****1111", "type": "credit" }
    },
    "expirationDate": "2030-12"
  }]
}

Autorizaciones

Authorization

string

header

requerido

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Cuerpo

application/json

merchantCode

string

requerido

Your merchant account identifier.

tokens

object[]

requerido

Cards to tokenize. Each entry carries a card instrument (cardData or nonceData) and an optional expirationDate.

shopper

object

Shopper information. Required when tokenizing a card (card.<instrument>.tokenize: true).

Show child attributes

Respuesta

200 - application/json

Tokens created

merchantCode

string

shopper

object

Show child attributes

tokens

object[]

Show child attributes

curl -X POST https://api.therius.io/v1/token \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "shopper": { "id": "customer-42", "email": "ada@example.com" },
    "tokens": [{
      "card": {
        "cardData": {
          "cardNumber": "4111111111111111",
          "cardholderName": "Ada Lovelace",
          "expiryMonth": "12",
          "expiryYear": "2030",
          "cvv": "123"
        }
      }
    }]
  }'

{
  "merchantCode": "MERCHANT_001",
  "shopper": { "id": "customer-42", "email": "ada@example.com" },
  "tokens": [{
    "id": "vt_abc123xyz",
    "card": {
      "cardData": { "brand": "visa", "cardNumber": "411111****1111", "type": "credit" }
    },
    "expirationDate": "2030-12"
  }]
}

Pagos

Tokenización

Suscripciones

Planes

Sesión del SDK

Almacena tokens de tarjeta para pagos futuros

Autorizaciones

Cuerpo

Respuesta