Pagos en Tiendas

Flujo para realizar cargos en tienda

1. El cliente confirma la compra en tu sitio web seleccionando como medio de pago tienda
2. Desde tu servidor se crea una referencia creando un cargo en Openpay
3. Con los datos obtenidos al crear la referencia se crea un recibo de pago personalizado
4. El cliente acude a alguna de las tiendas y realiza el pago
5. Openpay valida y recibe el pago
6. Openpay notifica la recepción del pago a tu servidor

En esta guía veremos los pasos número 2 y 3, para el paso número 6 consulta la sección de notificaciones

Crear cargo (Paso 2)

Para poder recibir un pago en una tienda es necesario que generes un código de barras que contiene la referencia con la cual tu cliente puede ir a la tienda a pagar.Para ello debes realizar una llamada a nuestra API de la siguiente manera:

$openpay = Openpay::getInstance('mzdtln0bmtms6o3kck8f','sk_e568c42a6c384b7ab02cd47d2e407cab');$chargeData = array('method' => 'store','amount' => 100.00,'description' => 'Cargo a tienda');$charge = $openpay->charges->create($chargeData);

Nota: El monto máximo que se permite para este tipo de cargos es de S/29,999.99 Si la llamada es correcta recibirás una respuesta con el número de referencia generado y la URL del código de barras para que puedas crear tu recibo.Respuesta:

{"id" : "t6utz9dywve6zipnppys","description" : "Cargo con tienda","error_message" : null,"authorization" : null,"amount" : 100,"operation_type" : "in","payment_method" : {"type" : "store","reference" : "123456ABCDEFGHIJLKMNOPQRSTVW010000","barcode_url" : "https://sandbox-api.openpay.pe/barcode/123456ABCDEFGHIJLKMNOPQRSTVW010000?width=1&height=45"},"order_id" : "oid-00052","transaction_type" : "charge","creation_date" : "2013-12-05T17:50:09-06:00","currency" : "MXN","status" : "in_progress","method" : "store"}

Sandbox: El pago puedes simularlo desde el dashboard, de esta manera puedes recibir una notificación de pago en tu sistema mediante un Webhook.Producción: La notificación de pago se realiza en tiempo real, es decir en el momento que tu cliente realice el pago en la tienda podrás recibir un Webhook y el saldo en tu cuenta se verá incrementado.Para mas información consulta la referencia de cargos

Recibo de pago (Paso 3)

Openpay brinda la posibilidad de obtener un recibo de pago con la información necesaria para que tu cliente pueda realizar el pago en tienda, para llegar a él, basta con estructurar una ruta compuesta de la siguiente manera:

{DASHBOARD_PATH}/paynet-pdf/{MERCHANT_ID}/{REFERENCE}

Sandbox: {DASHBOARD_PATH} = https://sandbox-dashboard.openpay.mxProducción: {DASHBOARD_PATH} = https://dashboard.openpay.mx{MERCHANT_ID} = tu id de comerciante{TRANSACTION_ID} = valor del campo payment_method.reference del objeto transacción regresado al crearse el cargoEjemplo: aquí

Crear Recibo de pago personalizado (Paso 3.1 Opcional)

Si decides no usar el recibo que ofrece Openpay puedes generarlo tu mismo, básicamente puedes crearlo con cualquier diseño y colores, pero debe incluir:

• Nombre del servicio a pagar
  • PAYNET
• Logotipos de las cadenas soportadas
  • Logotipos en Horizontal 1
  • Logotipos en Horizontal 2
  • Logotipos en Vertical
• Referencia:
  • Valor del campo reference
• Código de barras:
  • Imagen del campo barcode_url
• Monto a pagar:
  • Valor del campo amount

Ejemplo de recibo de pago (Paso 3.1 Opcional)