Card on File

Utilice la función de Card On File (CoF, por sus siglas en inglés) para procesar pagos recurrentes, suscripciones y transacciones con un solo clic. Esto ayuda a los comerciantes a cumplir con las regulaciones de Visa y Mastercard y mejora las tasas de aprobación.

Card On File (CoF) es una funcionalidad que permite a los comerciantes procesar transacciones utilizando la información de la tarjeta del cliente para compras posteriores. Esta capacidad facilita varios tipos de transacciones dependiendo de quién inicie la transacción, ya sea el cliente o el comerciante.

Resumen

Las redes de tarjetas requieren que los comerciantes incluyan identificadores específicos al utilizar credenciales de tarjetas almacenadas en la solicitud de pago. La funcionalidad de COF ayuda a establecer confianza, confirmando que los clientes han autorizado el almacenamiento de sus datos de tarjeta y los pagos posteriores.

Las transacciones de Card On File se pueden clasificar en tres tipos:

Nota

Consulte con su referente de cuenta sobre la disponibilidad de la funcionalidad de Card On File según el país.

Objeto CardOnFile

Campos de Solicitud

Parámetro	Tipo	¿Obligatorio?	Descripción
`CardOnFile`	`object`	No	Contiene información sobre la transacción de Card On File.
`CardOnFile` → `TransactionType`	`string`	Sí	Especifica el tipo de transacción de Card On File. Valores posibles: `"CIT"`, `"FIT"`, `"MIT"`.
`CardOnFile` → `NetworkTransactionId`	`string`	No	Identificador para el seguimiento de la transacción, puede ser una transacción de red o un acuerdo de suscripción.

Nota: El objeto CardOnFile es opcional. Las transacciones se procesarán normalmente si este objeto no se incluye en la solicitud. Sin embargo, incluirlo ayuda a mejorar las tasas de aprobación al identificar correctamente el tipo de transacción y cumplir con los requisitos de las redes de tarjetas.

Tipos de Transacción

	CIT	FIT	MIT
Iniciador	Cliente	Cliente	Comerciante
Casos de Uso	• Pagos con un solo clic • Compras en portales de clientes • Renovaciones manuales de suscripciones	• Inicio de una suscripción • Configuración de donaciones recurrentes	• Renovaciones de suscripciones • Cuotas recurrentes de membresía • Pagos programados en cuotas
Autenticación	Se recomienda autenticación. Puede proporcionar los resultados de 3DS en la solicitud	Se recomienda autenticación. Puede proporcionar los resultados de 3DS en la solicitud	No se necesita autenticación adicional después de FIT. Los datos de autenticación previos pueden ser referenciados usando NetworkTransactionId
TransactionID de Autenticación	Opcional	Opcional, pero se debe almacenar el `TransactionId` de la respuesta de 3DS	Opcional (`TransactionId` del FIT original)

Ejemplo de Solicitud para CIT (Transacción Iniciada por el Cliente)

{
    "CardData": {
        "CardHolderName": "João Silva",
        "Pan": "4507990000004905",
        "Expiration": "08/30",
        "Email": "joao.silva@example.com",
        "Document": "86461657055"
    },
    "UniqueID": "CIT-2023-001",
    "Capture": true,
    "TargetCountryISO": "BR",
    "Currency": "BRL",
    "Amount": 25000,
    "Order": "ORD-2023-001",
    "Description": "One-click purchase",
    "Customer": {
        "FirstName": "João",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber": "11987654321",
        "DocumentNumber": "86461657055",
        "DocumentType": "CPF.BR",
        "Email": "joao.silva@example.com",
        "Address": {
            "Country": "BR",
            "City": "São Paulo",
            "State": "SP",
            "PostalCode": "01310-200",
            "AddressDetail": "Avenida Paulista 1000"
        }
    },
    "CardOnFile": {
        "TransactionType": "CIT"
    }
}

Ejemplo de Solicitud para FIT (Primera Transacción Inicial)

{
    "CardData": {
        "CardHolderName": "João Silva",
        "Pan": "4507990000004905",
        "CVV": "123",
        "Expiration": "08/30",
        "Email": "joao.silva@example.com",
        "Document": "86461657055"
    },
    "UniqueID": "FIT-2023-001",
    "Capture": true,
    "TargetCountryISO": "BR",
    "Currency": "BRL",
    "Amount": 25000,
    "Order": "ORD-2023-002",
    "Description": "Subscription initial payment",
    "Customer": {
        "FirstName": "João",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber": "11987654321",
        "DocumentNumber": "86461657055",
        "DocumentType": "CPF.BR",
        "Email": "joao.silva@example.com",
        "Address": {
            "Country": "BR",
            "City": "São Paulo",
            "State": "SP",
            "PostalCode": "01310-200",
            "AddressDetail": "Avenida Paulista 1000"
        }
    },
    "ThreeDSAuthMethod": "EXTERNAL",
    "ThreeDS": {
        "Eci": "05",
        "Xid": "MDAwMDAwMDAwMDAwMDAwMDAwMDE=",
        "Cavv": "kBNcxqbmcXUxhAE1yKRHAAAAAAA=",
        "Version": "2.2.0",
        "TransactionId": "97267598-FAE6-48F2-8083-C23433990FBC"
    },
    "CardOnFile": {
        "TransactionType": "FIT"
    }
}

Ejemplo de Solicitud para MIT (Transacción Iniciada por el Merchant/Comercio)

{
    "CardData": {
        "CardHolderName": "João Silva",
        "Pan": "4507990000004905",
        "Expiration": "08/30",
        "Email": "joao.silva@example.com",
        "Document": "86461657055"
    },
    "UniqueID": "MIT-2023-001",
    "Capture": true,
    "TargetCountryISO": "BR",
    "Currency": "BRL",
    "Amount": 25000,
    "Order": "ORD-2023-003",
    "Description": "Subscription renewal payment",
    "Customer": {
        "FirstName": "João",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber": "11987654321",
        "DocumentNumber": "86461657055",
        "DocumentType": "CPF.BR",
        "Email": "joao.silva@example.com",
        "Address": {
            "Country": "BR",
            "City": "São Paulo",
            "State": "SP",
            "PostalCode": "01310-200",
            "AddressDetail": "Avenida Paulista 1000"
        }
    },
    "CardOnFile": {
        "TransactionType": "MIT",
        "NetworkTransactionId": "97267598-FAE6-48F2-8083-C23433990FBC"
    }
}

La respuesta sigue el formato estándar de respuesta. Consulte Crear una Compra para más detalles.

Última modificación 30 de diciembre de 2024