Tarjetas crédito y débito

Parámetros del Request

Se necesita incluir campos específicos para que este método de pago funcione correctamente. Consulte la sección Parámetros del Request para obtener información detallada sobre los parámetros de compra básica como el monto y la moneda.

Ejemplo del Request

{
    "TrxToken": "OT__6dHAgJo6qeg62qIroA7H7_f_NWZZ6IEx4jiYpVJ8SzQ_",
    "UniqueID": "paymentID3022",
    "Capture": true,
    "TargetCountryISO": "UY",
    "Currency": "UYU",
    "Amount": 25000,
    "Installments": 1,
    "Order": "CH2023-001",
    "Description": "Purchase Test",
    "Customer": {
        "FirstName": "Joao",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber": "11987654321",
        "DocumentNumber": "12345672",
        "DocumentType": "CPF.BR",
        "Email": "joao.silva@example.com",
        "Address": {
            "Country": "UY",
            "City": "Montevideo",
            "State": "Mdeo",
            "PostalCode": "11600",
            "AddressDetail": "Avenida Paulista 1000"
        }
    }
}

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

{
    "TransactionId": "79632697147789184",
    "Result": "COMPLETED",
    "Status": "APPROVED",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-08-07T17:51:54.620",
    "AuthorizationDate": "2024-08-07T17:51:56.879",
    "AuthorizationCode": "839936",
    "Amount": 25000,
    "Currency": "UYU",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
    "MetadataOut": null,
    "Action": null,
    "PaymentMethod": {
        "Brand": "Visa",
        "CardOwner": "Joao Silva",
        "Bin": "450799",
        "IssuerBank": "Santander",
        "Type": "CreditCard",
        "Expiration": "203008",
        "Last4": "4905"
    }
}

Tarjetas de prueba

Para generar información de tarjetas válidas para pruebas, debe establecer primero qué adquirente necesita probar y qué tipo de prueba quiere hacer.

Determinación del BIN

Al configurar un adquirente, también se crea el BIN (número de identificación bancaria) de la tarjeta. Este BIN debe coincidir con uno de los bines asociados a las marcas procesadas por el adquirente. Por ejemplo, si está realizando una prueba de integración con MasterCard, el BIN de la tarjeta generada debe ajustarse al siguiente formato: ^ 5 \ [1-5] \ [0-9]*

Este formato significa que debe comenzar con el número 5; el segundo número debe estar entre 1 y 5, luego se acepta cualquier otro número. Por ejemplo, el BIN a probar puede ser 510000. A continuación se enumeran los bines válidos en el sistema y su adquirente correspondiente.

Determinación de Comportamiento para el modelo PayFac

El comportamiento de la respuesta dependerá del monto enviado. Utilice las siguientes tarjetas para simular los diferentes estados de la compra.

Tarjetas sin CVV

Determinación de Comportamiento para el modelo Gateway

El comportamiento de la respuesta dependerá de la terminación de la tarjeta. Genere la tarjeta utilizando el bin de la marca correspondiente, y envíe los siguientes cuatro últimos dígitos de acuerdo con el resultado esperado.

Particularidades para el modelo Gateway

• Puede realizar compras a cuotas siempre que el Banco Emisor lo tenga habilitado.
• Puede realizar compras con Tarjetas de Débito siempre que el Banco Emisor lo tenga habilitado.
• Visanet exige la inclusión del CVV en la primera compra del cliente o en el alta del cliente.
  Una vez realizado el registro y obtenido el Commerce Token, no es necesario solicitar el CVV en futuras transacciones.
• Fiserv requiere que se envíe el CVV, incluso si tiene el Commerce Token. Debe ejecutar Flujo de solicitud de código de verificación.
  Esta modalidad está activada por defecto. Si desea desactivarla, debe negociar con Fiserv y notificarnoslo.
• Creditel y PassCard requieren que el mensaje de Purchase incluya el número y tipo de documento del tarjetahabiente (campos Customer.DocumentTypeId y Customer.DocNumber).
• PassCard requiere que se envíe el CVV, incluso si tiene el Commerce Token. Por lo tanto, debe ejecutar el Flujo de Solicitud de Código de Verificación.
• Cuando utilice OCAOneClick2 (OCA Multi-Acquiring), necesita incluir la dirección IP de la persona que está haciendo la compra. Para esto, debe enviar el parámetro CustomerIP en el request.

Compras utilizando MasterCard a través de OCA

Cuando utilice MasterCard en el model Gateway, se recomienda enviar el device FingerPrint utilizando el método SetDeviceFingerPrint.

Agregue esta función al script utilizado en para el formulario de Checkout (PWCheckOut) para generar y retornar el valor utilizado en la compra.

En este ejemplo, mostramos cómo invocar y obtener el resultado.

<script type="text/javascript">
    PWCheckout.SetDeviceFingerprint();
</script>

Luego, incluya el token en la creación de la compra de acuerdo con los siguientes escenarios.

• Para OneTimeToken, envíe el device FingerPrint que generó y el OT token.
• Para CommerceToken, existen dos casos:
  • Para compras recurrentes (sin CVV), envíe el device FingerPrint que genera y el CT token. Usted puede utilizar un CT token existente o generar uno nuevo.
  • Para compras con CVV, no es necesario generar un DeviceFingerPrint ya que cuando el cliente ingresa el CVV, el sistema envía el valor generado cuando se muestra la página de solicitud de CVV. Después, se genera una Compra en estado Pending y necesita redirigir al cliente a la URL retornada en el parámetro actionUrl donde ingresa el CVV.

Última modificación 12 de marzo de 2025

© Bamboo | All rights reserved 2025