---
title: "Crear una Transaction con medio de pago Card"
method: POST
path: "/cards/onetime/entry-point"
tags: ["Tarjetas"]
---

# Crear una Transaction con medio de pago Card

`POST /cards/onetime/entry-point`

## Request

- Base URL: `https://secure.api.trytoku.com`
- URL: `https://secure.api.trytoku.com/cards/onetime/entry-point`
- Auth: API key in header `x-api-key`

Este endpoint puede ser llamado de tres formas. La primera, mandando el body sin encriptación de ningún parámetro. La segunda, mandando el body con 'card_information' encriptado. La tercera, mandando todo el body encriptado. Para los últimos dos casos, mandar el parámetro 'encryption_key' es necesario.

## Headers

- `x-org-id` string, required

## Request body

- union
  - object
    - `amount` string
    - `card_information` union: Este parámetro también puede ser enviado como un string, si se desea mandar encriptado. En este caso, el parámetro 'encryption_key' es requerido.
      - object
        - `full_name` string, required
        - `month` string, required: MM
        - `number` string: Número de tarjeta. Es requerido si no se entrega un token
        - `token` string: Token asociado a una tarjeta. Puede ser usado en vez del número de tarjeta.
        - `verification_value` string, required
        - `year` string, required: YYYY
      - string: Los datos de tarjeta encriptados, en base64. Requiere enviar también `encryption_key`. Ver *Encriptación de la data*.
    - `customer_information` object: Requerido si no se entrega un ID de customer
      - `email` string, required
      - `phone_number` string
    - `encryption_key` string: Identificador con el que se llamo al endpoint para generar la llave de encriptación.
    - `engine` string: Valores posibles: SAAS (cuando pagando una invoice), GATEWAY (cuando pagando un amount)
    - `id_account` string, required
    - `id_customer` string: Requerido si el engine es "SAAS"
    - `id_invoices` string[]
    - `id_subscription` string
    - `installments` integer: Meses sin interés (solo algunos proveedores permiten esto)
    - `toku_product` string, required: Valores posibles: payment_orchestration_onetime
    - `transaction_external_id` string
  - object: El body completo encriptado con la llave de `encryption_key`.
    - `encrypted_data` string, required: El body completo encriptado, en base64.
    - `encryption_key` string, required: El identificador con el que generaste la llave.

## Response `200`

Operación exitosa.

- object
  - `item_type` string
  - `operation_id` string
  - `status` string
  - `toku_response_code` string
  - `transaction_details` object
    - `customer` object
      - `email` string
      - `external_id` string
      - `government_id` string
      - `id` string
      - `name` string
      - `phone_number` string
    - `payment_instrument` object
      - `account` unknown
      - `card` object
        - `bin` string
        - `card_brand` string
        - `card_holder` string
        - `card_type` string
        - `country` string
        - `exp_month` unknown
        - `exp_year` unknown
        - `external_id` unknown
        - `installments_number` integer
        - `issuer` string
        - `last_digits` string
        - `status` unknown
        - `three_d_secure` boolean
        - `token` unknown
      - `cash` unknown
      - `transfer` unknown
      - `type` string
      - `wallet` unknown
    - `payment_intents` object[]
      - `amount` integer
      - `currency` string
      - `gateway` string
      - `id` string
      - `id_account` string
      - `id_invoice` string
      - `id_subscription` string
      - `invoice_external_id` string
      - `price_change_amount` integer
      - `product_id` string
      - `status` string
      - `type` string
    - `transaction` object
      - `amount` integer
      - `currency` string
      - `id` string
      - `id_checkout_session` unknown
      - `response_code` string
      - `status` string
      - `transaction_date` string
      - `transaction_metadata` object
        - `enroll_card_toggle` boolean
      - `type` string
      - `voucher` unknown
    - `wallet_movements` object[]

## Other responses

- `400`: El request es inválido: revisa el body y los parámetros enviados.
- `401`: Unauthorized
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/trytoku/apis/pci-compliant-api.md) - [All operations](https://skmtc.dev/trytoku/apis/pci-compliant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/pci-compliant-api/revisions/9ff5e6a7d08b?raw)