Tarjetas crédito y débito

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

Consideraciones

  • Para VISA Débito: No es necesario estar en el programa Verified by Visa.
    Al operar fuera de una wallet, debe solicitar la Fecha de vencimiento y el CVV. Sirve como pago único por ser una tarjeta de débito. Permite cancelaciones totales y reembolsos (Totales y Parciales). No se permite operaciones en Dos Pasos (Preautorización).
  • Compras sin CVV: Permite tokenización y recurrencia.
    En el caso de la tokenización, la API genera un cargo por un mínimo de ARS 3, que se reembolsa para validar los datos del titular de la tarjeta. Con este token, es posible realizar compras sin CVV.

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.

PropiedadTipo¿Obligatorio?Descripción
TrxTokenstringSíToken que identifica la tarjeta del cliente.
Para más información sobre cómo crear el token, consulte Clientes.
TargetCountryISOstringSíIndica el país destino.
Customer → EmailstringSíCorreo electrónico del cliente.
Customer → FirstNamestringSíNombre del cliente.
Customer → LastNamestringSíApellido del cliente.
Customer → DocumentTypeIdnumericNoTipo de documento del cliente.
Consulte la tabla de tipos de documento para ver los posibles valores.
Customer → DocNumberstringNoNúmero de documento del cliente.
Customer → PhoneNumberstringNoNúmero de teléfono del cliente.
Customer → BillingAddress → CountrystringNoPaís del cliente.
Customer → BillingAddress → StatestringNo*Estado del cliente.
*Este parámetro es requerido para calcular el impuesto de II.BB. Consulte provincias para saber sus posibles valores.
Customer → BillingAddress → CitystringNoCiudad del cliente.
Customer → BillingAddress → AddressDetailstringNoDetalle de la dirección del cliente.
Customer → BillingAddress → PostalCodestringNoCódigo postal del cliente.

Ejemplo del Request

{
    "TrxToken":"OT__OjB6eMmXSzT9VZMK3yB-x_DO5YHx5QtP4jiYpVJ8SzQ_",
    "Capture":"true",
    "Amount":200000,
    "Currency":"ARS",
    "TargetCountryISO" : "AR",
    "Installments":1,
    "Order":"ORD12345",
    "Customer": {
        "Email": "eluna@mail.com",
        "BillingAddress": {
          "AddressType": 1,
          "Country": "AR",
          "State": "C",
          "City": "BsAs",
          "AddressDetail": "Joaquin Requena 1580",
          "PostalCode": "C1054AAU"
        },
        "FirstName" : "Erik",
        "LastName": "Luna",
        "DocNumber" : "12345672",
        "DocumentTypeId": 17,
        "PhoneNumber" : "24022330"
    },
    "Description" : "Compra de prueba"
}

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": 1167186,
        "Created": "2023-09-04T20:12:54.822",
        "TrxToken": null,
        "Order": "ORD12345",
        "Transaction": {
            "TransactionID": 1186083,
            "Created": "2023-09-04T20:12:54.822",
            "AuthorizationDate": "",
            "TransactionStatusId": 1,
            "Status": "Approved",
            "ErrorCode": null,
            "Description": " ",
            "ApprovalCode": null,
            "Steps": [
                {
                    "Step": "Generic External",
                    "Created": "",
                    "Status": null,
                    "ResponseCode": "approved",
                    "ResponseMessage": "approved",
                    "Error": null,
                    "AuthorizationCode": "171259",
                    "UniqueID": null,
                    "AcquirerResponseDetail": null
                }
            ]
        },
        "Capture": true,
        "Amount": 200000,
        "OriginalAmount": 200000,
        "TaxableAmount": 0,
        "Tip": 0,
        "Installments": 1,
        "Currency": "ARS",
        "Description": "Compra de prueba",
        "Customer": {
            "CustomerId": 251239,
            "Created": "2023-09-04T20:11:50.973",
            "CommerceCustomerId": null,
            "Owner": "Anonymous",
            "Email": "eluna@mail.com",
            "Enabled": true,
            "ShippingAddress": null,
            "BillingAddress": {
                "AddressId": 374731,
                "AddressType": 2,
                "Country": "AR",
                "State": "C",
                "AddressDetail": "Joaquin Requena 1580",
                "PostalCode": "C1054AAU",
                "City": "BsAs"
            },
            "Plans": null,
            "AdditionalData": null,
            "PaymentProfiles": [
                {
                    "PaymentProfileId": 256001,
                    "PaymentMediaId": 1,
                    "Created": "2023-09-04T20:11:50.973",
                    "LastUpdate": null,
                    "Brand": "VISA",
                    "CardOwner": "Erik Luna",
                    "Bin": "450799",
                    "IssuerBank": "Santander",
                    "Installments": "1;2;3;4;5;6;7;8;9;10;11;12",
                    "Type": "CreditCard",
                    "IdCommerceToken": 0,
                    "Token": null,
                    "Expiration": "202910",
                    "Last4": "4905",
                    "Enabled": null,
                    "DocumentNumber": null,
                    "DocumentTypeId": null,
                    "ExternalValue": null,
                    "AffinityGroup": null
                }
            ],
            "CaptureURL": null,
            "UniqueID": null,
            "URL": "https://api.stage.bamboopayment.com/Customer/251239",
            "FirstName": "Erik",
            "LastName": "Luna",
            "DocNumber": "12345672",
            "DocumentTypeId": 17,
            "PhoneNumber": "24022330",
            "ExternalValue": null
        },
        "RefundList": null,
        "PlanID": null,
        "UniqueID": null,
        "AdditionalData": null,
        "CustomerUserAgent": null,
        "CustomerIP": null,
        "URL": "https://api.stage.bamboopayment.com/Purchase/1167186",
        "DataUY": {
            "IsFinalConsumer": false,
            "Invoice": null,
            "TaxableAmount": 0
        },
        "DataDO": {
            "Invoice": null,
            "Tax": 0
        },
        "Acquirer": {
            "AcquirerID": 25,
            "Name": "DECIDIR",
            "CommerceNumber": null
        },
        "CommerceAction": null,
        "PurchasePaymentProfileId": 256001,
        "LoyaltyPlan": null,
        "DeviceFingerprintId": null,
        "MetadataIn": null,
        "MetadataOut": null,
        "CrossBorderData": null,
        "CrossBorderDataResponse": {
            "TargetCountryISO": "AR",
            "TargetCurrencyISO": "ARS",
            "TargetAmount": 2000
        },
        "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.

Para compras aprobadas

MarcaPANCVVFecha de ExpiraciónDetalles
Mastercard529991001000001512308/30Sin límite de monto.
Visa (crédito o débito)450799000000490512308/30Sin límite de monto.
Amex373953192351004123408/30Montos: $1 o $10

Para compras rechazadas

PANCVVFecha de ExpiraciónTipo de documentoDocumento
430496800155510461712/184 - DNI38499826
footer
Última modificación 24 de junio de 2024

© Bamboo | All rights reserved 2024