Tarjetas de crédito y débito
Las tarjetas de crédito y débito son el método de pago con tarjeta más común. Para obtener una lista de esquemas de tarjetas admitidos en American Express Payment Gateway, consulte los valores posibles para el campo sourceOfFunds.provided.card.brand en la Referencia de API.
Para identificar si la tarjeta utilizada para realizar un pago es una tarjeta de crédito, débito o cargo, envíe la solicitud RETRIEVE TRANSACTION y verifique el método de financiamiento (sourceOfFunds.provided.card.fundingMethod) devuelto en la respuesta. Puede utilizar los detalles del tipo de tarjeta para respaldar sus decisiones de sobrecargos.
Compatible con
Métodos de integración | Transacciones |
---|---|
Todos | Todas |
Para conocer las limitaciones de las transacciones que puede utilizar con métodos de integración específicos, consulte Hosted Checkout, Hosted Session, Web-Services API y Hosted Batch.
Sobre el método de pago
Las tarjetas de crédito ofrecen una línea de crédito a los titulares de tarjetas, permitiéndoles realizar compras y pagar más tarde con intereses, mientras que las tarjetas de débito deducen fondos directamente de la cuenta bancaria del titular de la tarjeta.
Tarjetas de crédito
Las transacciones con tarjeta de crédito conforman la mayoría de las transacciones de pago en el espacio del comercio electrónico. Los detalles de tarjeta, por lo general, incluyen el nombre del pagador, el número de tarjeta, la fecha de vencimiento y el código de seguridad de tarjeta.
Durante el proceso de pago,
- Dependiendo del método de integración, el sitio web o la aplicación del negocio recopila los detalles de la tarjeta y los envía al American Express Payment Gateway, o el pagador proporciona los detalles directamente al motor de pagos a través de campos hospedados o una página de pago hospedado.
- A partir del número de tarjeta, el motor de pagos identifica el esquema de la tarjeta y valida tanto el número de la tarjeta como el CSC (código de seguridad de tarjeta).
- Si la validación tiene éxito, el pago procede al banco adquirente.
Por ejemplo, el motor de pagos valida el CSC para el formato. En las tarjetas de crédito Visa y Mastercard, el CSC es el valor de tres dígitos impreso en el panel de firma en el reverso.


Para American Express, el número es el valor de 4 dígitos impreso en el anverso, encima del número de cuenta de la tarjeta de crédito.

Tarjetas de débito
Los pagos con tarjeta de débito se manejan de manera similar a los de las tarjetas de crédito. Los detalles de la tarjeta de débito suelen incluir el nombre del pagador, el número de la tarjeta, el vencimiento de la tarjeta y el CSC.
Preste atención a los siguientes datos de la tarjeta:
- Tarjetas Maestro: con las tarjetas de débito Maestro, todas las transacciones por Internet deben intentar al menos realizar una autenticación 3DS antes de realizar una transacción financiera. El motor de pagos procesa la transacción si se intenta la autenticación y se recibe una respuesta de autenticación distinta de la autenticación fallida. Si no se intenta la autenticación, el motor de pagos bloquea la transacción.
Si su vínculo de negocio-adquirente está configurado para la funcionalidad "Procesar reembolsos de Maestro como pagos", todas las transacciones REFUND con la fuente de transacción de INTERNET y la moneda de transacción INR se envían al adquirente como transacciones de pago.
- Tarjetas MADA: MADA se admite en Arabia Saudita como una tarjeta de marca compartida con Mastercard y Visa, así como tarjetas de marca única exclusivas de Mada. Los pagos procesados con tarjetas de marca compartida de Mada devuelven MADA_MASTERCARD o MADA_VISA en el campo localBrand de respuesta de transacción, mientras que los pagos procesados con tarjetas de marca única exclusivas de Mada devuelven MADA_ONLY. Todas las transacciones iniciadas por el titular de la tarjeta utilizando tarjetas MADA requieren autenticación 3DS.
- Tarjetas ITMX: ITMX se admite como tarjeta de marca compartida con Mastercard y Visa en Tailandia. Los pagos procesados con tarjetas de débito ITMX devuelven MASTERCARD_ITMX o VISA_ITMX en el campo localBrand en la respuesta de transacción. Todas las transacciones iniciadas por el titular de la tarjeta utilizando tarjetas ITMX requieren autenticación 3DS.
- Tarjetas EFTPOS: EFTPOS se admite como tarjeta de marca compartida con Mastercard y VISA en Australia. Los pagos procesados con tarjetas de débito EFTPOS devuelven EFTPOS en el campo localBrand en la respuesta de transacción.
Principales características compatibles
Al utilizar tarjetas de crédito y débito como método de pago, podrá hacer lo siguiente:
- Realizar pagos mediante un pago de una sola acción o transacciones de autorización y captura en dos pasos.
- Realizar devoluciones, anulaciones y desembolsos.
- Consultar y utilizar varias opciones de pago (como planes de pago y conversión dinámica de moneda).
- Agregar datos complementarios a sus solicitudes para que el pago sea más fácil de usar para el pagador o facilitar su procesamiento en el sistema de pago.
Detalles de pago requeridos
Cuando utilice tarjetas de crédito o débito, deberá proporcionar los siguientes datos de pago al motor de pagos. Dependiendo de la integración utilizada, el motor de pagos recopila los detalles a través de una página de pago hospedado, de campos hospedados dentro de una sesión o de una solicitud de transacción.
Se necesitan al menos los siguientes detalles:
- Método de pago (tarjeta)
- Número de tarjeta
- Mes y año de vencimiento de la tarjeta
- CSC
En una solicitud de transacción, estos detalles se proporcionan de la siguiente manera:
"sourceOfFunds": { "type": "CARD", "provided": { "card": { "number": "1000100010001000", "expiry": { "month": "10", "year": "26" }, "securityCode" : "123" } } }
Prerrequisitos
Para utilizar tarjetas de crédito y débito como método de pago:
- Su adquirente debe ser capaz de procesar pagos de débito y crédito.
- Debe acordar con su adquirente qué esquemas de tarjetas puede aceptar.
- Your payment service provider debe configurar el vínculo de negocio-adquirente en su perfil de negocio en consecuencia.
Agregar el método a tu integración
No se requieren personalizaciones adicionales para agregar tarjetas de crédito y débito a su integración después de implementar su integración genérica seleccionada. Para ver ejemplos de solicitudes de transacciones con tarjeta de crédito o débito, descargue la colección de Postman.
Prueba del método
Para obtener detalles sobre cómo probar su integración con tarjetas de crédito y débito, consulte Tarjetas de prueba y las instrucciones de prueba dentro de cada método de integración aplicable.