Pagos en Efectivo

Aprende a integrar pagos en efectivo para Colombia.

Este método permite a tus clientes generar un comprobante y pagar en puntos de pago físicos autorizados.

Puntos de pago disponibles

Puedes ofrecer a tus clientes la posibilidad de pagar en efectivo en las siguientes redes:

Logo	PaymentMethod	Descripción
	`APC`	Apostar
	`BCC`	Bancolombia
	`EFC`	Efecty
	`GNC`	Gana
	`PNC`	Puntored
	`SPC`	Superpagos
	`SRC`	SuRed
	`SSC`	SuSuerte

Parámetros de la petición

Para procesar pagos en efectivo, necesitas incluir campos específicos en tu solicitud. Para información sobre autenticación, idiomas de respuesta y parámetros básicos como monto y moneda, consulta el artículo sobre operación de compra.

Propiedad	Tipo	¿Obligatorio?	Descripción
`PaymentMethod`	`string`	Sí	Consulta el identificador en la tabla de Medios de pago.
`TargetCountryISO`	`string`	Sí	País donde se procesará el pago.
`Customer` → `Email`	`string`	Sí	Correo electrónico del cliente.
`Customer` → `FirstName`	`string`	No	Nombres del cliente.
`Customer` → `LastName`	`string`	No	Apellidos del cliente.
`Customer` → `DocumentType`	`string`	No	Tipo de documento del cliente. Consulta los valores disponibles en la tabla de tipos de documento.
`Customer` → `DocumentNumber`	`string`	Sí	Número de documento del cliente.
`Customer` → `PhoneNumber`	`string`	No	Teléfono del cliente.
`Customer` → `Address` → `Country`	`string`	No	País.
`Customer` → `Address` → `State`	`string`	No	Departamento.
`Customer` → `Address` → `City`	`string`	No	Ciudad.
`Customer` → `Address` → `AddressDetail`	`string`	No	Dirección completa.
`Customer` → `Address` → `PostalCode`	`string`	No	Código postal.
`MetaDataIn` → `PaymentExpirationInMinutes`	`numeric`	No	Tiempo de expiración del pago en minutos. Si no lo especificas, se aplicará un valor predeterminado.

Importante

Los montos en Pesos Colombianos no admiten decimales, todos los valores se redondean automáticamente.
El campo amount debe incluir dos ceros como decimales. Por ejemplo, para COP 5.000 debes enviar 500000.

El estado de la compra para Medios de Pago Alternativos como Cash, permanecerá en Pending hasta que el cliente complete el pago en el punto físico.

Ejemplo de petición

{
    "PaymentMethod": "EFC",
    "Order": "CH2023-001",
    "Amount": 100000,
    "Currency": "COP",
    "Description": "Purchase Test",
    "TargetCountryISO": "CO",
    "Customer": {
        "FirstName": "Joao",
        "LastName": "Silva",
        "Email": "joao.silva@example.com",
        "DocumentType":"CC.CO",
        "DocumentNumber":"12345672",
        "PhoneNumber":"3188060418",
        "ReferenceCode":"123123"  
    },
    "MetaDataIn": {
        "PaymentExpirationInMinutes": "7200"
    }
}

Parámetros de respuesta

Recibirás los siguientes parámetros en la respuesta:

Propiedad	Tipo	Descripción
`Response` → `Action` → `URL`	`string`	URL del comprobante que el cliente debe presentar en el punto de pago.
`Response` → `MetadataOut` → `PaymentCode`	`string`	Código de referencia que identifica la orden de pago.
`Response` → `MetadataOut` → `PaymentExpirationDate`	`date`	Fecha de vencimiento del pago. Formato DD/MM/AAAA.
`Response` → `MetadataOut` → `AgreementCode`	`string`	Número de convenio entre el punto de pago y el adquirente.

Para más detalles sobre los parámetros de respuesta, consulta la sección de parámetros en la documentación de Compras.

Ejemplo de respuesta

{
    "TransactionId": "79632697147789184",
    "Result": "ACTION_REQUIRED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-08-07T17:51:54.620",
    "AuthorizationDate": null,
    "AuthorizationCode": null,
    "Amount": 100000,
    "Currency": "COP",
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
    "MetadataOut":{
        "PaymentCode": "6273036",
        "PaymentExpirationDate": "22/08/2023",
        "AgreementCode": "110342"
    },
    "Action": {
        "URL": "https://s3.amazonaws.com/gateway.stage.bamboopayment.com/purchase-coupons/1131277_691e4de3-6eda-43ce-a01d-a6ea539d70fe_20231117.html",
        "Reason": "REDIRECTION_NEEDED_EXTERNAL_SERVICE"
    },
     "PaymentMethod": {
        "Brand": "PayvalidaCashPFCO",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Última modificación 20 de diciembre de 2024