Efectivo

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

Info

El estado de la compra para Medios Alternativos de Pago permanecerá en Pending hasta que el cliente complete el 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

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

	Descripción
	Apostar
	Bancolombia
	Efecty
	Gana
	Puntored
	Superpagos
	SuRed
	SuSuerte

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
`PaymentMethodId`	`string`	Sí	Encuentre el valor 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.

Consideraciones

Los Pesos Colombianos no soportan cantidades decimales, por lo que todos los valores recibidos serán redondeados.
El valor amount debe incluir dos ceros como decimales. Ejemplo COP 5.000 > 500000.

Ejemplo del Request

{
    "PaymentMethodId": "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 del Response

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

Propiedad	Tipo	Descripción
`Response` → `Action` → `URL`	`string`	URL del cupón que debe ser presentado en la red física.
`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": "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 18 de noviembre de 2024