Medios alternativos de pago

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

Info

El estado de la compra para PagoEfectivo y Redes de cobranza en efectivo permanecerá en Pending hasta que el cliente complete el pago.
El estado de la compra para Yape será aprobado o rechazado en cuanto envíe la transacción.

PagoEfectivo Perú

PagoEfectivo provee una red de centros de pago físicos donde sus clientes pueden pagar las compras en efectivo o utilizando su aplicación bancaria. Su cliente puede pagar mostrando el identificador de la deuda (CIP) en una oficina o a través de su aplicación bancaria.

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í	El `PaymentMediaId` para este medio de pago es 26.
`TargetCountryISO`	`string`	Sí	Indica el país destino.
`Customer` → `Email`	`string`	Sí	Correo electrónico del cliente.
`Customer` → `FirstName`	`string`	Sí	Nombre del cliente.
`Customer` → `LastName`	`string`	Sí	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. El número de teléfono debe tener el formato `<característica>\|<número>`. Ejemplo: `+51\|971516229`.
`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. La fecha de expiración debe ser de al menos 10 minutos y menos de seis meses a partir de la fecha actual (en UTC GMT -5).

Ejemplo del Request

{
    "PaymentMediaId": "26",
    "Amount": 1000,
    "MetadataIn": {
        "PaymentExpirationInMinutes": "1440"
    },
    "Currency": "PEN",
    "TargetCountryISO": "PE",
    "Capture": true,
    "Customer": {
        "Email": "rguerrero@mail.com",
        "FirstName": "Rodrigo",
        "LastName": "Guerrero",
        "PhoneNumber": "+51|971516229",
        "DocNumber": "46701208",
        "DocumentTypeId": 6
    },
    "Description": "Prueba Peru efectivo"
}

Parámetros del Response

En el Response, se encuentran los siguientes parámetros:

Propiedad	Tipo	Descripción
`Response` → `MetadataOut` → `PaymentCode`	`string`	Código de pago generado por PagoEfectivo.
`Response` → `MetadataOut` → `PaymentExpirationDate`	`date`	Fecha de expiración del CIP. Formato ISO 8601.
`Response` → `MetadataOut` → `PaymentUrl`	`string`	URL del documento HTML del CIP.

PrintScreen

Ejemplo del Response

{
    "Response": {
        "PurchaseId": 1134346,
        "Created": "2023-09-01T20:08:12.328",
        "TrxToken": null,
        "Order": null,
        "Transaction": {
            "TransactionID": 1153224,
            "Created": "2023-09-01T20:08:12.327",
            "AuthorizationDate": "",
            "TransactionStatusId": 2,
            "Status": "Pending",
            "ErrorCode": null,
            "Description": "100 Solicitud exitosa.",
            "ApprovalCode": null,
            "Steps": [
                {
                    "Step": "Pago Efectivo Get Token",
                    "Created": "2023-09-01T20:08:13.940",
                    "Status": "Get Token OK",
                    "ResponseCode": "100",
                    "ResponseMessage": "Solicitud exitosa.",
                    "Error": "",
                    "AuthorizationCode": null,
                    "UniqueID": null,
                    "AcquirerResponseDetail": null
                },
                {
                    "Step": "Pago Efectivo Generate CIP",
                    "Created": "2023-09-01T20:08:14.267",
                    "Status": "PhysicalNetwork Pending",
                    "ResponseCode": "100",
                    "ResponseMessage": "Solicitud exitosa.",
                    "Error": "",
                    "AuthorizationCode": null,
                    "UniqueID": null,
                    "AcquirerResponseDetail": "{'code':'100','message':'Solicitud exitosa.','cip':'1344682','operationNumber':null}"
                }
            ]
        },
        "Capture": true,
        "Amount": 1000,
        "OriginalAmount": 1000,
        "TaxableAmount": 0,
        "Tip": 0,
        "Installments": 1,
        "Currency": "PEN",
        "Description": "Prueba Peru efectivo",
        "Customer": {
            "CustomerId": 251048,
            "Created": "2023-09-01T20:08:11.420",
            "CommerceCustomerId": null,
            "Owner": "Anonymous",
            "Email": "rguerrero@mail.com",
            "Enabled": true,
            "ShippingAddress": null,
            "BillingAddress": null,
            "Plans": null,
            "AdditionalData": null,
            "PaymentProfiles": [
                {
                    "PaymentProfileId": 255802,
                    "PaymentMediaId": 26,
                    "Created": "2023-09-01T20:08:11.527",
                    "LastUpdate": "2023-09-01T20:08:11.910",
                    "Brand": "PagoEfectivoPeru",
                    "CardOwner": null,
                    "Bin": null,
                    "IssuerBank": null,
                    "Installments": null,
                    "Type": "PhysicalNetwork",
                    "IdCommerceToken": 0,
                    "Token": null,
                    "Expiration": null,
                    "Last4": "",
                    "Enabled": null,
                    "DocumentNumber": "46701208",
                    "DocumentTypeId": 6,
                    "ExternalValue": null,
                    "AffinityGroup": null
                }
            ],
            "CaptureURL": null,
            "UniqueID": null,
            "URL": "https://api.stage.bamboopayment.com/Customer/251048",
            "FirstName": "Rodrigo",
            "LastName": "Guerrero",
            "DocNumber": "46701208",
            "DocumentTypeId": 6,
            "PhoneNumber": "+51|971516229",
            "ExternalValue": null
        },
        "RefundList": null,
        "PlanID": null,
        "UniqueID": null,
        "AdditionalData": null,
        "CustomerUserAgent": null,
        "CustomerIP": null,
        "URL": "https://api.stage.bamboopayment.com/Purchase/1134346",
        "DataUY": {
            "IsFinalConsumer": false,
            "Invoice": null,
            "TaxableAmount": 0
        },
        "DataDO": {
            "Invoice": null,
            "Tax": 0
        },
        "Acquirer": {
            "AcquirerID": 35,
            "Name": "PagoEfectivo Perú",
            "CommerceNumber": null
        },
        "CommerceAction": null,
        "PurchasePaymentProfileId": 255802,
        "LoyaltyPlan": null,
        "DeviceFingerprintId": null,
        "MetadataIn": {
            "PaymentExpirationInMinutes": "1440"
        },
        "MetadataOut": {
            "PaymentCode": "1344682",
            "PaymentExpirationDate": "2023-09-02T15:08:13-05:00",
            "PaymentUrl": "https://pre1a.payment.pagoefectivo.pe/9814A6D7-2EE8-47BC-84B9-505DE4E7492E.html"
        },
        "CrossBorderData": null,
        "CrossBorderDataResponse": {
            "TargetCountryISO": "PE",
            "TargetCurrencyISO": "PEN",
            "TargetAmount": 10
        },
        "Redirection": null,
        "IsFirstRecurrentPurchase": false,
        "AntifraudData": {
            "AntifraudFingerprintId": null,
            "AntifraudMetadataIn": null
        },
        "PaymentMediaId": null,
        "PurchaseType": 1,
        "HasCvv": null,
        "TargetCountryISO": null
    },
    "Errors": []
}

Redes de cobranza en efectivo

Utilizando este método de pago, su cliente puede dirigirse a una red de cobranza de efectivo y completar el pago utilizando el número de referencia generado.

Redes

Puede ofrecer a su cliente la posibilidad de pagar en efectivo en las siguientes redes:

	Payment MediaId	Descripción
	46	BCP
	47	Caja Arequipa
	48	Caja Cusco
	49	Caja Huancayo
	50	Caja Ica
	51	Caja Piura
	52	Caja Tacna
	53	Caja Trujillo
	54	Interbank
	55	Western Union
	103	BBVA

Parámetros del Request

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`	No	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`	No	Número de teléfono del cliente.
`Customer` → `BillingAddress` → `Country`	`string`	No	País del cliente.
`Customer` → `BillingAddress` → `State`	`string`	No	Departamento 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": 55,
    "Currency": "USD",
    "TargetCountryISO": "PE",
    "MetadataIn": {
        "PaymentExpirationInMinutes": "15"
    },
    "Customer": {
        "Email": "rguerrero@mail.com",
        "FirstName": "Rodrigo",
        "LastName": "Guerrero",
        "PhoneNumber": "+51|971516229",
        "DocNumber": "46701208",
        "DocumentTypeId": 6
    },
    "Amount": 100,
    "Installments": 1,
    "Capture": true,
    "Description": "Cash test"
}

Parámetros del Response

En el Response, se encuentran los siguientes parámetros:

Propiedad	Tipo	Descripción
`Response` → `MetadataOut` → `PaymentUrl`	`string`	URL de la información del pago.
`Response` → `MetadataOut` → `PaymentCode`	`string`	Referencia de pago retornada por el adquirente que identifica la orden generada.
`Response` → `MetadataOut` → `PaymentExpirationDate`	`date`	Fecha de expiración del pago. Formato DD/MM/AAAA.
`Response` → `MetadataOut` → `AgreementCode`	`string`	Número de convenio entre el adquirente y la red física.

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": 148346,
        "Created": "2023-10-11T18:20:14.465",
        "TrxToken": null,
        "Order": null,
        "Transaction": {
            "TransactionID": 159251,
            "Created": "2023-10-11T18:20:14.465",
            "AuthorizationDate": "",
            "TransactionStatusId": 2,
            "Status": "Pending",
            "ErrorCode": null,
            "Description": " ",
            "ApprovalCode": null,
            "Steps": [
                {
                    "Step": "Generic External",
                    "Created": "2023-10-11T18:20:15.227",
                    "Status": null,
                    "ResponseCode": "0000",
                    "ResponseMessage": "OK",
                    "Error": null,
                    "AuthorizationCode": "7851376",
                    "UniqueID": null,
                    "AcquirerResponseDetail": "{\"Operacion\":\"CREADA\",\"OrdenID\":\"148346\",\"PVOrdenID\":\"3468502\",\"Referencia\":\"7851376\"}"
                }
            ]
        },
        "Capture": true,
        "Amount": 306,
        "OriginalAmount": 306,
        "TaxableAmount": 0,
        "Tip": 0,
        "Installments": 1,
        "Currency": "PEN",
        "Description": "Cash test",
        "Customer": {
            "CustomerId": 70118,
            "Created": "2023-10-11T18:20:14.070",
            "CommerceCustomerId": null,
            "Owner": "Anonymous",
            "Email": "rguerrero@mail.com",
            "Enabled": true,
            "ShippingAddress": null,
            "BillingAddress": null,
            "Plans": null,
            "AdditionalData": null,
            "PaymentProfiles": [
                {
                    "PaymentProfileId": 71937,
                    "PaymentMediaId": 55,
                    "Created": "2023-10-11T18:20:14.117",
                    "LastUpdate": "2023-10-11T18:20:14.203",
                    "Brand": "WesternUnion",
                    "CardOwner": null,
                    "Bin": null,
                    "IssuerBank": null,
                    "Installments": null,
                    "Type": "PhysicalNetwork",
                    "IdCommerceToken": 0,
                    "Token": null,
                    "Expiration": null,
                    "Last4": "",
                    "Enabled": null,
                    "DocumentNumber": "46701208",
                    "DocumentTypeId": 2,
                    "ExternalValue": null,
                    "AffinityGroup": null
                }
            ],
            "CaptureURL": null,
            "UniqueID": null,
            "URL": "https://api.dev.bamboopayment.com/Customer/70118",
            "FirstName": "Rodrigo",
            "LastName": "Guerrero",
            "DocNumber": "46701208",
            "DocumentTypeId": 6,
            "PhoneNumber": "+51|971516229",
            "ExternalValue": null
        },
        "RefundList": null,
        "PlanID": null,
        "UniqueID": null,
        "AdditionalData": null,
        "CustomerUserAgent": null,
        "CustomerIP": null,
        "URL": "https://api.dev.bamboopayment.com/Purchase/148346",
        "DataUY": {
            "IsFinalConsumer": false,
            "Invoice": null,
            "TaxableAmount": 0
        },
        "DataDO": {
            "Invoice": null,
            "Tax": 0
        },
        "Acquirer": {
            "AcquirerID": 101,
            "Name": "PayvalidaCashPFPE",
            "CommerceNumber": null
        },
        "CommerceAction": null,
        "PurchasePaymentProfileId": 71937,
        "LoyaltyPlan": null,
        "DeviceFingerprintId": null,
        "MetadataIn": {
            "PaymentExpirationInMinutes": "15"
        },
        "MetadataOut": {
            "PaymentUrl": "https://s3.amazonaws.com/gateway.dev.bamboopayment.com/purchase-coupons/148346_ab14bee9-1870-4711-a656-9e308d37126a_20240111.html",
            "PaymentCode": "7851376",
            "PaymentExpirationDate": "11/10/2023",
            "AgreementCode": "PAYVALIDA"
        },
        "CrossBorderData": null,
        "CrossBorderDataResponse": {
            "TargetCountryISO": "PE",
            "TargetCurrencyISO": "USD",
            "TargetAmount": 1
        },
        "Redirection": null,
        "IsFirstRecurrentPurchase": false,
        "AntifraudData": {
            "AntifraudFingerprintId": null,
            "AntifraudMetadataIn": null
        },
        "PaymentMediaId": null,
        "PurchaseType": 1,
        "HasCvv": null,
        "TargetCountryISO": null
    },
    "Errors": []
}

Yape

Yape, un sistema de pago por móvil ampliamente adoptado en Perú, ofrece a los ciudadanos una forma cómoda de realizar transacciones a través del teléfono inteligente. Al vincular sin problemas sus cuentas bancarias a la aplicación Yape, los clientes pueden pagar productos y servicios sin esfuerzo.

A diferencia de otros APM en Perú, el flujo de Yape funciona de forma similar a las transacciones con tarjeta. Sin embargo, en lugar de compartir la información de la tarjeta, sólo es necesario proporcionar el número de teléfono y el código de autorización generado por el cliente en la aplicación de Yape.

Flujo de pago

El siguiente diagrama presenta el flujo de pago utilizado para pagar con Yape.

PrintScreen

El cliente selecciona Yape como medio de pago.
Usted debe mostrar el formulario para capturar el número de celular y el código de autorización.
El cliente abre la app Yape y genera un nuevo código de autorización.
El cliente introduce su número de celular y el código de autorización generado previamente.
Bamboo procesa la transacción y devuelve un estado aprobado o rechazado.

Parámetros del Request

Propiedad	Tipo	¿Obligatorio?	Descripción
`PaymentMediaId`	`numeric`	Sí	El `PaymentMediaId` para este medio de pago es 540.
`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`	Sí	Número de documento del cliente.
`Customer` → `PhoneNumber`	`string`	No	Número de teléfono del cliente. Max 9 caracteres
`Customer` → `BillingAddress` → `Country`	`string`	No	País del cliente.
`Customer` → `BillingAddress` → `State`	`string`	No	Departamento 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.
`MetaDataIn` → `phoneNumber`	`numeric`	Sí	Número de celular del usuario de Yape.
`MetaDataIn` → `otp`	`numeric`	Sí	Código de autorización generado por el usuario de Yape.

Ejemplo del Request

{
    "PaymentMediaId": 540,
    "Order": "QA994",
    "Capture": "true",
    "Amount": 3000,
    "Installments": 1,
    "Currency": "USD",
    "CrossBorderData": {
        "TargetCountryISO": "PE"
    },
    "Description": "Compra de prueba",
    "Customer": {
        "Email": "rguerrero@mail.com",
        "BillingAddress": {
            "AddressType": 1,
            "Country": "Peru",
            "State": "Lima y Callao",
            "City": "Lima",
            "AddressDetail": "Avenida Jaime Bauzate Y Meza, 593"
        },
        "FirstName": "Rodrigo",
        "LastName": "Guerrero",
        "DocNumber": "46701208",
        "DocumentTypeId": 6,
        "PhoneNumber": "969929157"
    },
    "MetadataIn": {
        "PaymentExpirationInMinutes": "1440",
        "phoneNumber": "969929157",
        "otp": "557454"
    }
}

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": 1276919,
        "Created": "2024-03-11T13:48:24.296",
        "TrxToken": null,
        "Order": "QA994",
        "Transaction": {
            "TransactionID": 1297685,
            "Created": "2024-03-11T13:48:24.296",
            "AuthorizationDate": "2024-03-11T13:48:24.896",
            "TransactionStatusId": 1,
            "Status": "Approved",
            "ErrorCode": null,
            "Description": " ",
            "ApprovalCode": "160105",
            "Steps": [
                {
                    "Step": "Generic External",
                    "Created": "2024-03-11T13:48:24.904",
                    "Status": null,
                    "ResponseCode": "000",
                    "ResponseMessage": "Authorization Aprobado y completado con exito.",
                    "Error": null,
                    "AuthorizationCode": "160105",
                    "UniqueID": null,
                    "AcquirerResponseDetail": "Authorization Aprobado y completado con exito."
                }
            ]
        },
        "Capture": true,
        "Amount": 13280,
        "OriginalAmount": 13280,
        "TaxableAmount": null,
        "Tip": 0,
        "Installments": 1,
        "Currency": "PEN",
        "Description": "Compra de prueba",
        "Customer": {
            "CustomerId": 277774,
            "Created": "2024-03-11T13:48:23.983",
            "CommerceCustomerId": null,
            "Owner": "Anonymous",
            "Email": "rguerrero@mail.com",
            "Enabled": true,
            "ShippingAddress": null,
            "BillingAddress": {
                "AddressId": 396672,
                "AddressType": 2,
                "Country": "Peru",
                "State": "Lima y Callao",
                "AddressDetail": "Avenida Jaime Bauzate Y Meza, 593",
                "PostalCode": null,
                "City": "Lima"
            },
            "Plans": null,
            "AdditionalData": null,
            "PaymentProfiles": [
                {
                    "PaymentProfileId": 283184,
                    "PaymentMediaId": 540,
                    "Created": "2024-03-11T13:48:24.113",
                    "LastUpdate": "2024-03-11T13:48:24.147",
                    "Brand": "Yape",
                    "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/277774",
            "FirstName": "Rodrigo",
            "LastName": "Guerrero",
            "DocNumber": "46701208",
            "DocumentTypeId": 6,
            "PhoneNumber": "969929157",
            "ExternalValue": null
        },
        "RefundList": null,
        "PlanID": null,
        "UniqueID": null,
        "AdditionalData": null,
        "CustomerUserAgent": null,
        "CustomerIP": null,
        "URL": "https://api.stage.bamboopayment.com/Purchase/1276919",
        "DataUY": {
            "IsFinalConsumer": false,
            "Invoice": null,
            "TaxableAmount": null
        },
        "DataDO": {
            "Invoice": null,
            "Tax": null
        },
        "Acquirer": {
            "AcquirerID": 153,
            "Name": "Yape",
            "CommerceNumber": null
        },
        "CommerceAction": null,
        "PurchasePaymentProfileId": 283184,
        "LoyaltyPlan": null,
        "DeviceFingerprintId": null,
        "MetadataIn": {
            "PaymentExpirationInMinutes": "1440",
            "phoneNumber": "969929157",
            "otp": "557454"
        },
        "MetadataOut": null,
        "CrossBorderData": null,
        "CrossBorderDataResponse": {
            "TargetCountryISO": "PE",
            "TargetCurrencyISO": "USD",
            "TargetAmount": 30
        },
        "Redirection": null,
        "IsFirstRecurrentPurchase": false,
        "AntifraudData": {
            "AntifraudFingerprintId": null,
            "AntifraudMetadataIn": null
        },
        "PaymentMediaId": null,
        "PurchaseType": 1,
        "HasCvv": null,
        "TargetCountryISO": null
    },
    "Errors": []
}

Última modificación 19 de septiembre de 2024