PagoEfectivo

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

Info

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

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
`PaymentMethod`	`string`	Sí	Consulta el identificador en la tabla de Medios de pago.
`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` → `DocumentType`	`string`	No	Tipo de documento del cliente. Consulte la tabla de tipos de documento para ver los posibles valores.
`Customer` → `DocumentNumber`	`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` → `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. 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

{
	"PaymentMethod": "PEC",
    "Order": "CH2023-001",
	"Amount": 100,
    "Currency": "PEN",
    "TargetCountryISO": "PE",
    "Customer": {
        "FirstName": "Joao",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber":"+51971516229"
        "DocumentNumber": "12345678901",
        "DocumentType": "DNI.PE",
        "Email": "joao.silva@example.com",
        "Address": {
            "Country": "PE",
            "City": "Lima",
            "State": "SP",
            "PostalCode": "01310-200",
            "AddressDetail": "Avenida Paulista 1000"
        }
    },
	"MetaDataIn": {
        "PaymentExpirationInMinutes": "1440"
    }
}

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

{
    "TransactionId": "135483617504670912",
    "Result": "COMPLETED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2025-01-08T20:43:31.580",
    "AuthorizationDate": "2025-01-08T20:43:32.263",
    "AuthorizationCode": null,
    "Amount": 378,
    "Currency": "PEN",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/135483617504670912",
    "MetadataOut": {
        "PaymentCode": "1691391",
        "PaymentUrl": "https://pre1a.payment.pagoefectivo.pe/A7272995-6F97-422E-BB5B-9D0A25BB47EF.html",
        "PaymentExpirationDate": "2025-01-08T15:58:31-05:00"
    },
    "Action": null,
    "PaymentMethod": {
        "Brand": "PagoEfectivoPeru",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Última modificación 20 de enero de 2025