Tarjetas crédito y débito

Aprenda cómo integrar su solución para procesar pagos con tarjetas crédito o débito.

Puede crear la compra utilizando el flujo API o Redirect.

Consideraciones

Las tarjetas de débito que utilizan el flujo API están disponibles para la captura completa (operación de compra).
El CVV es obligatorio para las tarjetas de débito.
El tiempo máximo para confirmar una transacción es de siete días calendario.
Chile no soporta montos decimales, por lo que todos los valores de monto recibidos serán redondeados.

Pagos con tarjeta mediante flujo API

Utilizando este flujo, puede ofrecer la posibilidad de recibir pagos con tarjetas sin la intervención del pagador.

Parámetros del Request

Es necesario incluir campos específicos para que este método de pago funcione correctamente. Consulte el artículo operación de compra para obtener información detallada sobre la autenticación, los idiomas de la respuesta y los parámetros de compra básica como el monto y la moneda.

Propiedad	Tipo	¿Obligatorio?	Descripción
`TrxToken`	`string`	Sí	Token que identifica la tarjeta del cliente. Para más información sobre cómo crear el token, consulte Clientes.
`TargetCountryISO`	`string`	Sí	Indica el país destino.
`Customer` → `Email`	`string`	Sí	Correo electrónico del cliente.
`Customer` → `FirstName`	`string`	No	Nombre del cliente.
`Customer` → `LastName`	`string`	No	Apellido del cliente.
`Customer` → `DocumentTypeId`	`numeric`	No	Tipo de documento del cliente. Consulte la tabla de tipos de documento para ver los posibles valores.
`Customer` → `DocNumber`	`string`	No	Número de documento del cliente.
`Customer` → `PhoneNumber`	`string`	No	Número de teléfono del cliente.
`Customer` → `BillingAddress` → `Country`	`string`	No	País del cliente.
`Customer` → `BillingAddress` → `State`	`string`	No	Estado del cliente.
`Customer` → `BillingAddress` → `City`	`string`	No	Ciudad del cliente.
`Customer` → `BillingAddress` → `AddressDetail`	`string`	No	Detalle de la dirección del cliente.
`Customer` → `BillingAddress` → `PostalCode`	`string`	No	Código postal del cliente.

Info

Recuerde que para el correcto funcionamiento del sistema antifraude, sugerimos enviar la información adicional descrita en la sección Antifraude.

Ejemplo del Request

{
    "TrxToken": "OT__S5iqUBO8ZQCdfjtSIrTR_0-bknqY42K14jiYpVJ8SzQ_",
    "Capture": "true",
    "Amount": 100,
    "Order": "ORD1233",
    "Currency": "CLP",
    "TargetCountryISO": "CL",
    "Installments": 1,
    "Customer": {
        "Email": "jgonzalez@mail.com",
        "FirstName": "Jaime",
        "LastName": "Gonzalez"
    },
    "Description": "Prueba transaccion API"
}

Parámetros del Response

Para más información sobre los parámetros del Response, consulte la sección de parámetros de la creación de la compra.

Ejemplo del Response

{
    "Response": {
        "PurchaseId": 1133755,
        "Created": "2023-08-31T20:05:27.780",
        "TrxToken": null,
        "Order": "ORD1233",
        "Transaction": {
            "TransactionID": 1152672,
            "Created": "2023-08-31T20:05:27.780",
            "AuthorizationDate": "",
            "TransactionStatusId": 1,
            "Status": "Approved",
            "ErrorCode": "",
            "Description": " ",
            "ApprovalCode": null,
            "Steps": [
                {
                    "Step": "Generic External",
                    "Created": "",
                    "Status": null,
                    "ResponseCode": "",
                    "ResponseMessage": "AUTHORIZED",
                    "Error": "",
                    "AuthorizationCode": "1213",
                    "UniqueID": null,
                    "AcquirerResponseDetail": "AUTHORIZED"
                }
            ]
        },
        "Capture": true,
        "Amount": 100,
        "OriginalAmount": 100,
        "TaxableAmount": 0,
        "Tip": 0,
        "Installments": 1,
        "Currency": "CLP",
        "Description": "Prueba transaccion API",
        "Customer": {
            "CustomerId": 250623,
            "Created": "2023-08-31T20:04:44.033",
            "CommerceCustomerId": null,
            "Owner": "Anonymous",
            "Email": "jgonzalez@mail.com",
            "Enabled": true,
            "ShippingAddress": null,
            "BillingAddress": null,
            "Plans": null,
            "AdditionalData": null,
            "PaymentProfiles": [
                {
                    "PaymentProfileId": 255370,
                    "PaymentMediaId": 1,
                    "Created": "2023-08-31T20:04:44.033",
                    "LastUpdate": "2023-08-31T20:04:50.143",
                    "Brand": "VISA",
                    "CardOwner": "Jhon Doe Chile",
                    "Bin": "405188",
                    "IssuerBank": "Visa",
                    "Installments": "1;2;3;4;5;6;7;8;9;10;11;12;13;14;15;16;17;18;19;20;21;22;23;24",
                    "Type": "CreditCard",
                    "IdCommerceToken": 0,
                    "Token": null,
                    "Expiration": "202910",
                    "Last4": "6623",
                    "Enabled": null,
                    "DocumentNumber": null,
                    "DocumentTypeId": null,
                    "ExternalValue": null,
                    "AffinityGroup": null
                }
            ],
            "CaptureURL": null,
            "UniqueID": null,
            "URL": "https://api.stage.bamboopayment.com/Customer/250623",
            "FirstName": "Jaime",
            "LastName": "Gonzalez",
            "DocNumber": null,
            "DocumentTypeId": null,
            "PhoneNumber": null,
            "ExternalValue": null
        },
        "RefundList": null,
        "PlanID": null,
        "UniqueID": null,
        "AdditionalData": null,
        "CustomerUserAgent": null,
        "CustomerIP": null,
        "URL": "https://api.stage.bamboopayment.com/Purchase/1133755",
        "DataUY": {
            "IsFinalConsumer": false,
            "Invoice": null,
            "TaxableAmount": 0
        },
        "DataDO": {
            "Invoice": null,
            "Tax": 0
        },
        "Acquirer": {
            "AcquirerID": 79,
            "Name": "Transbank Api",
            "CommerceNumber": null
        },
        "CommerceAction": null,
        "PurchasePaymentProfileId": 255370,
        "LoyaltyPlan": null,
        "DeviceFingerprintId": null,
        "MetadataIn": null,
        "MetadataOut": null,
        "CrossBorderData": null,
        "CrossBorderDataResponse": {
            "TargetCountryISO": "CL",
            "TargetCurrencyISO": "CLP",
            "TargetAmount": 1
        },
        "Redirection": null,
        "IsFirstRecurrentPurchase": false,
        "AntifraudData": {
            "AntifraudFingerprintId": null,
            "AntifraudMetadataIn": null
        },
        "PaymentMediaId": null,
        "PurchaseType": 1,
        "HasCvv": null,
        "TargetCountryISO": null
    },
    "Errors": []
}

Tarjetas de prueba

Utilice las siguientes tarjetas para simular los diferentes estados de la compra. Estas tarjetas aplican tanto para el flujo API como para el de Redirect.

Para compras aprobadas

Marca	PAN	CVV	Fecha de Expiración	Tipo
Amex	`370000000002032`	`1234`	`10/29`	Crédito
Visa	`4051885600446623`	`123`	`10/29`	Crédito
Visa	`4051886000056590`	`123`	`10/29`	Prepago

Info note

Si se solicitan RUT y contraseña, utilice un RUT válido (por ejemplo 11.111.111-1) y contraseña 123.

Para compras rechazadas

Marca	PAN	CVV	Fecha de Expiración	Tipo
MasterCard	`5186059559590568`	`123`	`10/29`	Crédito
MasterCard	`5186174110629480`	`123`	`10/29`	Prepago

Última modificación 19 de septiembre de 2024