Medios alternativos de pago

Aprenda a integrar su solución para procesar pagos con cash and Bank transfers.

Info

El estado de la compra para Medios Alternativos de Pago permanecerá en Pending hasta que el cliente complete el pago ya sea en su aplicación bancaria o en una oficina física de pago.

Efectivo

El método de pago en efectivo permite a sus clientes generar un cupón y completar el pago en una oficina de pago física.

Redes de pago en efectivo

	Payment MediaId	Acquirer
	5	Abitab
	10	RedPagos

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
`PaymentMediaId`	`numeric`	Sí	Envíe el `PaymentMediaId` de acuerdo con la red de pago en efectivo en esta tabla.
`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`	Sí	Tipo de documento del cliente. Consulte la tabla de tipos de documento para ver los posibles valores.
`Customer` → `DocNumber`	`string`	Sí	Número de documento del cliente.
`Customer` → `PhoneNumber`	`string`	Sí	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.
`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

{
    "PaymentMediaId": 10,
    "Order": "ORD1",
    "Amount": 2000,
    "Description":"Test transaction",
    "TargetCountryISO": "UY",
    "MetadataIn": {
        "PaymentExpirationInMinutes": "1440"
    },
    "Currency": "UYU",
    "Capture": true,
    "Customer": {
        "Email": "testuser@mail.com",
        "BillingAddress": {
          "AddressType": 1,
          "Country": "Uruguay",
          "State": "Montevideo",
          "City": "Montevideo",
          "AddressDetail": "La Paz 1020"
        },
        "FirstName" : "Mark",
        "LastName": "Doe",
        "DocNumber" : "12345672",
        "DocumentTypeId": 2,
        "PhoneNumber" : "099111222"
    }
}

Parámetros del Response

En el parámetro MetadataOut.PaymentBarcodeUrl de la respuesta, se retorna el cupon en formato PDF que el cliente debe presentar en la agencia para pagar la deuda generada.

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": 1131112,
        "Created": "2023-08-16T20:39:35.973",
        "Order": "ORD1",
        "Transaction": {
            "TransactionID": 1149013,
            "Created": "2023-08-16T20:39:35.973",
            "AuthorizationDate": "",
            "TransactionStatusId": 2,
            "Status": "Pending",
            "Description": " ",
            "Steps": [
                {
                    "Step": "Generic External",
                    "Created": "",
                    "ResponseCode": "0",
                    "ResponseMessage": "Transaction registered in PagosWeb",
                    "AcquirerResponseDetail": "{\"TransactionIdFromPW\":\"190511\",\"PaymentBarcodeUrl\":\"Https://gateway.stage.bamboopayment.com/purchase-coupons/PW_190511_20230817.pdf\"}"
                }
            ]
        },
        "Capture": true,
        "Amount": 2000,
        "OriginalAmount": 2000,
        "TaxableAmount": 0,
        "Tip": 0,
        "Installments": 1,
        "Currency": "UYU",
        "Description": "Transaccion de prueba redpagos",
        "Customer": {
            "CustomerId": 248794,
            "Created": "2023-08-16T20:39:35.000",
            "Owner": "Anonymous",
            "Email": "fsum@mail.com",
            "Enabled": true,
            "PaymentProfiles": [
                {
                    "PaymentProfileId": 253461,
                    "PaymentMediaId": 10,
                    "Created": "2023-08-16T20:39:35.110",
                    "LastUpdate": "2023-08-16T20:39:35.613",
                    "Brand": "RedPagos",
                    "Type": "PhysicalNetwork",
                    "IdCommerceToken": 0,
                    "Last4": "",
                    "DocumentNumber": "12345672",
                    "DocumentTypeId": 2
                }
            ],
            "URL": "https://api.stage.bamboopayment.com/Customer/248794",
            "FirstName": "Rose",
            "LastName": "Astrid",
            "DocNumber": "12345672",
            "DocumentTypeId": 2,
            "PhoneNumber": "099111222"
        },
        "URL": "https://api.stage.bamboopayment.com/Purchase/1131112",
        "DataUY": {
            "IsFinalConsumer": false,
            "TaxableAmount": 0
        },
        "DataDO": {
            "Tax": 0
        },
        "Acquirer": {
            "AcquirerID": 71,
            "Name": "RedPagosPayFac"
        },
        "PurchasePaymentProfileId": 253461,
        "MetadataIn": {
            "PaymentExpirationInMinutes": "1440"
        },
        "MetadataOut": {
            "TransactionIdFromPW": "190511",
            "PaymentBarcodeUrl": "Https://gateway.stage.bamboopayment.com/purchase-coupons/PW_190511_20230817.pdf"
        },
        "CrossBorderDataResponse": {
            "TargetCountryISO": "UY",
            "TargetCurrencyISO": "UYU",
            "TargetAmount": 20
        },
        "IsFirstRecurrentPurchase": false,
        "AntifraudData": {},
        "PurchaseType": 1
    },
    "Errors": []
}

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

Propiedad	Tipo	¿Obligatorio?	Descripción
`PaymentMediaId`	`numeric`	Sí	El `PaymentMediaId` para este medio de pago es 532.
`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` → `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.
`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

{
	"PaymentMediaId": 532,
	"Order": "QA83",
	"Amount": 100,
	"Description" : "Test Purchase",
    "Currency": "UYU",
    "TargetCountryISO": "UY",
    "Customer": {
        "Email": "john@mail.com",
        "FirstName": "John",
        "LastName": "Smith",
        "DocNumber": "12345672",
        "DocumentTypeId": 2,
        "PhoneNumber": "24022330",
        "BillingAddress": {
            "AddressType": 1,
            "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 CommerceAction con ActionReason como REDIRECTION_NEEDED_EXTERNAL_SERVICE y el parámetro ActionURL 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

{
    "Response": {
        "PurchaseId": 1260840,
        "Created": "2023-12-14T11:01:12.829",
        "TrxToken": null,
        "Order": "QA83",
        "Transaction": {
            "TransactionID": 1280797,
            "Created": "2023-12-14T11:01:12.829",
            "AuthorizationDate": "",
            "TransactionStatusId": 2,
            "Status": "Pending",
            "ErrorCode": null,
            "Description": " ",
            "ApprovalCode": null,
            "Steps": [
                {
                    "Step": "Generic External",
                    "Created": "2023-12-14T14:01:12.829",
                    "Status": "Pending for Redirection",
                    "ResponseCode": null,
                    "ResponseMessage": null,
                    "Error": null,
                    "AuthorizationCode": null,
                    "UniqueID": null,
                    "AcquirerResponseDetail": null
                }
            ]
        },
        "Capture": true,
        "Amount": 3188058,
        "OriginalAmount": 3188058,
        "TaxableAmount": null,
        "Tip": 0,
        "Installments": 1,
        "Currency": "UYU",
        "Description": "Compra de prueba",
        "Customer": {
            "CustomerId": 263761,
            "Created": "2023-12-14T11:01:12.473",
            "CommerceCustomerId": null,
            "Owner": "Anonymous",
            "Email": "testuser@mail.com",
            "Enabled": true,
            "ShippingAddress": null,
            "BillingAddress": {
                "AddressId": 0,
                "AddressType": 1,
                "Country": "Uruguay",
                "State": "Montevideo",
                "AddressDetail": "La Paz 1020",
                "PostalCode": null,
                "City": "Montevideo"
            },
            "Plans": null,
            "AdditionalData": null,
            "PaymentProfiles": [
                {
                    "PaymentProfileId": 268802,
                    "PaymentMediaId": 532,
                    "Created": "2023-12-14T14:01:12.597",
                    "LastUpdate": "2023-12-14T14:01:12.670",
                    "Brand": "Infinia",
                    "CardOwner": null,
                    "Bin": null,
                    "IssuerBank": null,
                    "Installments": null,
                    "Type": "BankTransfer",
                    "IdCommerceToken": 0,
                    "Token": null,
                    "Expiration": null,
                    "Last4": "",
                    "Enabled": null,
                    "DocumentNumber": null,
                    "DocumentTypeId": null,
                    "ExternalValue": null,
                    "AffinityGroup": null
                }
            ],
            "CaptureURL": null,
            "UniqueID": null,
            "URL": "https://api.stage.bamboopayment.com/Customer/263761",
            "FirstName": "Mark",
            "LastName": "Doe",
            "DocNumber": "12345672",
            "DocumentTypeId": 2,
            "PhoneNumber": "099111222",
            "ExternalValue": null
        },
        "RefundList": null,
        "PlanID": null,
        "UniqueID": null,
        "AdditionalData": null,
        "CustomerUserAgent": null,
        "CustomerIP": null,
        "URL": "https://api.stage.bamboopayment.com/Purchase/1260840",
        "DataUY": {
            "IsFinalConsumer": false,
            "Invoice": null,
            "TaxableAmount": null
        },
        "DataDO": {
            "Invoice": null,
            "Tax": null
        },
        "Acquirer": {
            "AcquirerID": 91,
            "Name": "Infinia Redirect",
            "CommerceNumber": null
        },
        "CommerceAction": {
            "ActionType": 1,
            "ActionReason": "REDIRECTION_NEEDED_EXTERNAL_SERVICE",
            "ActionURL": "https://redirect.stage.bamboopayment.com/CA_0cf91fa5-953c-43e9-8fb1-8ebb030d6748",
            "ActionBody": null,
            "ActionSessionId": "CA_0cf91fa5-953c-43e9-8fb1-8ebb030d6748"
        },
        "PurchasePaymentProfileId": 268802,
        "LoyaltyPlan": null,
        "DeviceFingerprintId": null,
        "MetadataIn": {
            "PaymentExpirationInMinutes": "60"
        },
        "MetadataOut": null,
        "CrossBorderData": null,
        "CrossBorderDataResponse": {
            "TargetCountryISO": "UY",
            "TargetCurrencyISO": "USD",
            "TargetAmount": 1000
        },
        "Redirection": null,
        "IsFirstRecurrentPurchase": false,
        "AntifraudData": {
            "AntifraudFingerprintId": null,
            "AntifraudMetadataIn": null
        },
        "PaymentMediaId": null,
        "PurchaseType": 1,
        "HasCvv": null,
        "TargetCountryISO": null
    },
    "Errors": []
}

Experiencia de pago

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

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 18 de noviembre de 2024