Transferencias bancarias

Aprenda a integrar su solución para procesar pagos con transferencias bancarias.

Info

El estado de la compra para transferencias bancarias permanecerá en Pending hasta que el cliente complete el pago.

Transferencias Bancarias

Transferencias Bancarias permiten que tus clientes realicen pagos utilizando transferencias bancarias. Los clientes deben transferir el monto de la compra a los detalles de la cuenta especificados en la respuesta utilizando su banco de preferencia. Aceptamos pagos de todos los bancos.

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
`PaymentMethod`	`string`	Sí	Consulta el identificador en la tabla de Medios de pago.
`TargetCountryISO`	`string`	Sí	Indica el país destino.
`Description`	`string`	Sí	Descripción de la compra. Para este medio de pago es obligatorio.
`Customer` → `Email`	`string`	Sí	Correo electrónico del cliente.
`Customer` → `FirstName`	`string`	No	Nombre del cliente.
`Customer` → `LastName`	`string`	No	Apellido del cliente.
`Customer` → `DocumentType`	`string`	No	Tipo de documento del cliente. Consulte la tabla de tipos de documento para ver los posibles valores.
`Customer` → `DocumentNumber`	`string`	No	Número de documento del cliente.
`Customer` → `PhoneNumber`	`string`	No	Número de teléfono del cliente.
`Customer` → `Address` → `Country`	`string`	No	País del cliente.
`Customer` → `Address` → `State`	`string`	No	Estado del cliente.
`Customer` → `Address` → `City`	`string`	No	Ciudad del cliente.
`Customer` → `Address` → `AddressDetail`	`string`	No	Detalle de la dirección del cliente.
`Customer` → `Address` → `PostalCode`	`string`	No	Código postal del cliente.
`MetaDataIn` → `PaymentExpirationInMinutes`	`numeric`	No	Configure el tiempo de expiración del pago a través de este campo, especificando la duración en minutos. Si no envía este campo, la API asignará un valor por defecto.

Ejemplo del Request

{
	"PaymentMethod": "BTU",
	"Order": "QA83",
	"Amount": 100,
	"Description" : "Test Purchase",
    "Currency": "UYU",
    "TargetCountryISO": "UY",
    "Customer": {
        "Email": "john@mail.com",
        "FirstName": "John",
        "LastName": "Smith",
        "DocumentNumber": "12345672",
        "DocumentType": "CI.UY",
        "PhoneNumber": "24022330",
        "Address": {
            "Country": "Uruguay",
            "State": "Montevideo",
            "City": "Montevideo",
            "AddressDetail": "Av. Sarmiento 22",
            "PostalCode": "150000"
        }
    },
	"MetaDataIn": {
        "PaymentExpirationInMinutes": 60
    },
    "Redirection": {
        "Url_Approved": "https://dummystore.com/checkout/response",
        "Url_Rejected": "https://dummystore.com/checkout/response",
        "Url_Canceled": "https://dummystore.com/checkout/response",
        "Url_Pending": "https://dummystore.com/checkout/response"
    }
}

Parámetros del Response

Retornamos la compra (Purchase) con estado Pending for Redirection y un objeto Action con Reason como REDIRECTION_NEEDED_EXTERNAL_SERVICE y el parámetro URL con la URL del cupón. En esta URL, el pagador debe iniciar sesión en su aplicación de home banking y completar el pago. Consulte la sección Experiencia de pago para ver el flujo de pago.

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": "135845766093616960",
    "Result": "ACTION_REQUIRED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2025-01-09T20:42:34.562",
    "AuthorizationDate": null,
    "AuthorizationCode": null,
    "Amount": 4365,
    "Currency": "UYU",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/135845766093616960",
    "MetadataOut": null,
    "Action": {
        "SessionId": "CA_14d2639f-6b0a-41a5-af4f-07e619955d9a",
        "URL": "https://redirect.stage.bamboopayment.com/CA_14d2639f-6b0a-41a5-af4f-07e619955d9a",
        "Reason": "REDIRECTION_NEEDED_EXTERNAL_SERVICE"
    },
    "PaymentMethod": {
        "Brand": "Infinia",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "BankTransfer",
        "Expiration": null,
        "Last4": null
    }
}

Experiencia de pago

Como se ha mencionado, debe redirigir a su cliente a la URL devuelta en la respuesta (parámetro Action.URL).

A continuación, mostramos a su cliente el cupón con la información bancaria a la que debe crear la transferencia.

PrintScreen

Info

Puede personalizar este cupón para que muestre su logotipo en la parte superior. Para incluirlo, póngase en contacto con el servicio de soporte de Bamboo.

Una vez que su cliente complete la transferencia, podrá utilizar el botón de confirmación situado en la parte inferior de esta pantalla.

Última modificación 20 de enero de 2025