Pagos en Efectivo

Aprenda cómo integrar su solución para procesar pagos en sucursales físicas de pago.

Info

El estado de la compra para Medios de pago Efectivo, permanecerá en Pending hasta que el cliente complete el pago en una oficina física de pago.

OXXOPay

OXXO, la cadena de tiendas de autoservicio más grande de México, ofrece un servicio para que sus clientes paguen sus compras. Sus clientes deben entregar el cupón en la tienda y pueden pagar utilizando efectivo o tarjetas.

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` → `DocumentNumber`	`string`	No	Número de documento del cliente.
`Customer` → `PhoneNumber`	`string`	Yes	Número de teléfono del cliente. Incluyendo el indicativo para México `+52`
`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`	Yes	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": "OXP",
	"Amount": 100,
    "TargetCountryISO": "MX",
	"Currency": "USD",
	"Customer": {
		"Email": "lucia@test.com",
		"FirstName": "Lucia",
		"LastName": "Perez",
		"PhoneNumber": "+525532100000",
		"Address": {
			"Country": "Mexico",
			"State": "Ciudad de Mexico",
			"City": "Coyoacan",
			"AddressDetail": "Av Universidad 3000"
		}
	},
    "MetaDataIn": {
        "PaymentExpirationInMinutes": "7200"
    }
}

Parámetros del Response

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

Propiedad	Tipo	Descripción
`Response` → `MetadataOut` → `PaymentUrl`	`string`	URL del cupón de pago.
`Response` → `MetadataOut` → `PaymentCode`	`string`	Referencia de pago.
`Response` → `MetadataOut` → `PaymentBarcodeUrl`	`string`	URL de la imagen del código de barras del pago.

Puede redirigir a su cliente a la URL mostrada en el parámetro Response.MetadataOut.PaymentUrl, donde podrá imprimir el cupón y completar el pago en una tienda OXXO.

Ejemplo del Response

{
    "TransactionId": "128598955264065792",
    "Result": "COMPLETED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-12-20T20:46:20.199",
    "AuthorizationDate": "2024-12-20T20:46:20.674",
    "AuthorizationCode": "",
    "Amount": 1000,
    "Currency": "MXN",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.bamboopayment.com/Purchase/128598955264065792",
    "MetadataOut": {
        "PaymentUrl": "https://s3.amazonaws.com/gateway.stage.bamboopayment.com/purchase-coupons/1399000_77f1b5ed-329a-4872-984d-d6490e2307ee_00010101.html",
        "PaymentCode": "4300000013990006",
        "PaymentBarcodeUrl": "https://gateway.stage.bamboopayment.com/integrations/oxxo/barcodes/NDMwMDAwMDAxMzk5MDAwNg==.jpeg"
    },
    "Action": null,
    "PaymentMethod": {
        "Brand": "OxxoPay",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Efectivo Paynet

Paynet le permite a sus clientes generar un cupón y realizar el pago en una tienda física.

Redes de pago en efectivo

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

Farmacias Benavides
7Eleven
Walmart
Farmacias de Ahorro
Sam´s
Walmart Express
Bodega Aurrera
Circle K

Parámetros del Request

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`	No	Apellido del cliente.
`Customer` → `DocumentNumber`	`string`	No	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	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.

Ejemplo del Request

{
	"PaymentMethod": "PYN",
	"Amount": 1000,
    "TargetCountryISO": "MX",
	"Currency": "MXN",
	"Customer": {
		"Email": "lucia@test.com",
		"FirstName": "Lucia",
		"LastName": "Perez",
		"PhoneNumber": "525532100000",
		"Address": {
			"Country": "Mexico",
			"State": "Ciudad de Mexico",
			"City": "Coyoacan",
			"AddressDetail": "Av Universidad 3000"
		}
	},
    "MetaDataIn": {
        "PaymentExpirationInMinutes": "7200"
    }
}

Parámetros del Response

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

Propiedad	Tipo	Descripción
`Response` → `MetadataOut` → `PaymentCode`	`string`	Referencia de pago generado por Paynet.
`Response` → `MetadataOut` → `PaymentBarcodeUrl`	`string`	URL de la imagen del código de barras del pago.
`Response` → `MetadataOut` → `PaymentUrl`	`string`	URL del cupón de pago en formato PDF.

Puede redirigir a su cliente a la URL mostrada en el parámetro Response.MetadataOut.PaymentUrl para descargar el cupón y realizar el pago en una sucursal física de pago.

Ejemplo del Response

{
    "TransactionId": "128598955264065792",
    "Result": "COMPLETED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-12-20T20:46:20.199",
    "AuthorizationDate": "2024-12-20T20:46:20.674",
    "AuthorizationCode": "",
    "Amount": 1000,
    "Currency": "MXN",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.bamboopayment.com/Purchase/128598955264065792",
    "MetadataOut": {
        "PaymentCode": "9988780335829741",
        "PaymentBarcodeUrl": "https://sandbox-api.openpay.mx/barcode/9988780335829741?width=1&height=45&text=false",
        "PaymentUrl": "https://sandbox-dashboard.openpay.mx/paynet-pdf/m46uqwpxz7otrhsinbx1/9988780335829741"
    },
    "Action": null,
    "PaymentMethod": {
        "Brand": "OpenPayPayNet",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Última modificación 20 de diciembre de 2024