Redes de cobranza en efectivo

Aprenda a integrar su solución para procesar pagos con redes de cobranza en efectivo.

Info

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

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:

	PaymentMethod	Descripción
	`BCP`	BCP
	`ARC`	Caja Arequipa
	`CSC`	Caja Cusco
	`HCC`	Caja Huancayo
	`ICC`	Caja Ica
	`PIC`	Caja Piura
	`TNC`	Caja Tacna
	`TRC`	Caja Trujillo
	`IBC`	Interbank
	`WUC`	Western Union
	`BBV`	BBVA

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`	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`	Sí	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	Departamento 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": "BCP",
    "Order": "CH2023-001",
	"Amount": 100,
    "Currency": "PEN",
    "TargetCountryISO": "PE",
    "Customer": {
        "FirstName": "Joao",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber":"936023105"
        "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` → `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

{
    "TransactionId": "135483816503424192",
    "Result": "COMPLETED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2025-01-08T20:44:19.039",
    "AuthorizationDate": "2025-01-08T20:44:19.088",
    "AuthorizationCode": "429801",
    "Amount": 378,
    "Currency": "PEN",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/135483816503424192",
    "MetadataOut": {
        "AuthorizationCode": "429801",
        "OperationId": "345231",
        "TransactionNumber": "802092"
    },
    "Action": null,
    "PaymentMethod": {
        "Brand": "Bcp",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Última modificación 20 de enero de 2025