v1

latestOpenAPI 3.1.02026-07-24820248.4 KB

Crear una Transaction con medio de pago Card

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.

post/cards/onetime/entry-point

Request body

id_customerstring

Requerido si el engine es "SAAS"

toku_productstring required

Valores posibles: payment_orchestration_onetime

id_invoicesstring[]

amountstring

enginestring

Valores posibles: SAAS (cuando pagando una invoice), GATEWAY (cuando pagando un amount)

id_accountstring required

installmentsinteger

Meses sin interés (solo algunos proveedores permiten esto)

id_subscriptionstring

transaction_external_idstring

encryption_keystring

Identificador con el que se llamo al endpoint para generar la llave de encriptación.

Response

200

statusstring

item_typestring

toku_response_codestring

operation_idstring

Example response

{
  "status": "SUCCESS",
  "item_type": "PAYMENT",
  "toku_response_code": "SUEVO0000",
  "operation_id": "trs_DcZiucIBENAQJ33XRNqomGQZcZ0HZGB6",
  "transaction_details": {
    "transaction": {
      "id": "trs_jwZpTbVb0RwcnaB2xTf19nBYH-s1z_NT",
      "type": "PAYMENT",
      "amount": 210,
      "currency": "MXN",
      "transaction_date": "2025-01-14T15:20:36.071334",
      "status": "SUCCESS",
      "response_code": "SUEVO0000"
    },
    "customer": {
      "id": "cus_LDrzHO79tg5hvJSGgax6TkWfxYPL5AEh",
      "external_id": "MOZN960827HGRSGC02",
      "email": "example@trytoku.com",
      "government_id": "MOZN960827HGRSGC02",
      "name": "Example",
      "phone_number": "+521234567890"
    },
    "payment_intents": [
      {
        "id": "pi_lKJ2kHgh9BtSJMmonHD900GIqNw5Qxba",
        "amount": 210,
        "currency": "MXN",
        "id_invoice": "in_jnxXeRgPQBxm9AtuxMX9gG8vg2FBXkJi",
        "id_subscription": "sub_XUdItB7ghG3XMQVUo81qy-PLeVYuIAQ4",
        "invoice_external_id": "example-product-2025-02-04",
        "id_account": "acc_jwONBafuYIcaaQuHrRPeHJI8Gve-r-M4",
        "gateway": "po_evo_payments",
        "price_change_amount": 10,
        "product_id": "example-product",
        "status": "AUTHORIZED",
        "type": "one_time"
      }
    ],
    "payment_instrument": {
      "type": "card",
      "card": {
        "bin": "512345",
        "card_type": "credit",
        "card_brand": "MASTERCARD",
        "country": "Ecuador",
        "card_holder": "Example Man",
        "issuer": "ec_banco_pichincha_c_a",
        "installments_number": 1,
        "last_digits": "0008"
      }
    }
  }
}