Prepara tus sistemas para Shop Cash

Antes de lanzar los flujos de trabajo de Shop Cash con sistemas externos, confirma los siguientes requisitos:

• Los sistemas ERP, de gestión de pedidos (OMS), de preparación de pedidos, de contabilidad y de devoluciones pueden aceptar más de una forma de pago en un solo pedido.
• shop_cash está asignado como forma de pago donde los valores de la pasarela están disponibles.
• Shop Cash no se trata como un descuento, tarjeta de regalo ni crédito en tienda.
• El valor de autorización se almacena como una cadena opaca de longitud variable de al menos 1024 caracteres. Si es posible, usa un campo de texto sin límite.
• Las capturas, anulaciones y reembolsos se identifican mediante la identificación de la transacción en lugar del valor de autorización. Las operaciones de captura y anulación de la Admin API usan parentTransactionId, y las operaciones de reembolso usan parentId.
• Los sistemas no analizan, decodifican, normalizan, convierten en hash ni truncan los valores de autorización de Shop Cash.
• Los sistemas pueden procesar pagos agrupados, en los que una fila shop_cash_credit puede representar varios pedidos.
• El flujo de trabajo de conciliación no asume que un pedido equivale a una fila de pago.
• El flujo de trabajo de conciliación puede procesar la parte de Shop Cash y la parte de tarjeta o de Cuotas de Shop Pay que se liquidan en pagos diferentes.
• El flujo de trabajo de reembolsos puede procesar reembolsos parciales con tarjeta o Cuotas de Shop Pay y Shop Cash.
• Las apps de reembolso pueden reembolsar la transacción de captura de Shop Cash, no la transacción de autorización.
• Si usaste Shop Campaigns antes de enero de 2026, el flujo de trabajo financiero procesa las filas históricas de shop_cash_campaign_billing_debit y las filas de facturación de campañas relacionadas de forma independiente del ingreso del pedido. A partir de enero de 2026, los costos de la campaña se cobran en tu factura de Shopify en su lugar.

Las pruebas de Shop Cash tienen limitaciones porque este depende de las cuentas de comprador de Shop, los saldos de Shop Cash, Shopify Payments y la infraestructura de liquidación de Shop Cash.

La manera más confiable de validar una integración empresarial de extremo a extremo es realizar un pedido de producción de bajo valor a través de Shop y luego reembolsarlo. Esto crea transacciones de pedido similares a las de producción, captura datos, actividad de pagos, transacciones de reembolso y actividad de débito de reembolso que fluyen por el panel de control de Shopify, los datos de la Admin API, las exportaciones de pagos y los datos de la API de pagos.

Las tiendas en desarrollo pueden ayudar a validar algunas estructuras de campos de la API y la lógica de asignación, pero no aplican de manera confiable todo el flujo de pago que se origina en Shop, el saldo del comprador ni el flujo de liquidación. El modo de prueba y la pasarela de prueba (Bogus) no crean filas de pago de Shop Cash similares a las de producción porque no usan un flujo de liquidación activo de Shopify Payments.

Por lo general, puedes probar los siguientes flujos de trabajo con un pedido de producción de bajo valor iniciado desde Shop:

• La recepción de pedidos para un pedido con múltiples formas de pago que incluye Shop Cash y Shop Pay o Cuotas de Shop Pay.
• La asignación en ERP u OMS para shop_cash.
• El almacenamiento de todo el valor de autorización de Shop Cash.
• Reembolsos totales y parciales sobre el pedido.
• La recepción de la actividad de pago shop_cash_refund_debit.
• La conciliación de pagos para los créditos de Shop Cash.
• El comportamiento de los pedidos en preventa o la captura al preparar el pedido, si tu tienda usa captura diferida.
• La gestión en las apps de devolución para pedidos con más de una forma de pago.

Cuando hagas pruebas en producción, usa un pedido de bajo valor y sigue los procedimientos internos de pedido de prueba y reembolso de tu tienda.

Contacta a atención al cliente de Shopify si necesitas ayuda con alguno de los siguientes escenarios:

• Revisar la disponibilidad de Shop Cash para un mercado que está en despliegue.
• Investigar un reembolso o captura de Shop Cash fallidos.
• Investigar una transacción de pago de Shop Cash faltante después de la cadencia de pago normal, más un ciclo de pago adicional.
• Revisar si se puede volver a autorizar una autorización de Shop Cash anulada o vencida.
• Planificar un lanzamiento para un flujo de trabajo complejo de ERP, OMS, pedidos en preventa o preparación de pedidos.

Antes de escalar el volumen de pedidos de Shop Cash, completa las siguientes verificaciones:

• La asignación de forma de pago en ERP y OMS está implementada y verificada para shop_cash.
• Un pedido de muestra de Shop Cash se recibe de extremo a extremo, incluidas las transacciones de autorización y captura.
• Un crédito de pago de muestra de Shop Cash se concilia con el pedido o los pedidos de origen.
• Un reembolso de muestra de Shop Cash se procesa y concilia con el débito de reembolso.
• Las filas de pago agrupadas de Shop Cash son compatibles o tienen un proceso de conciliación manual.
• Tus equipos de ayuda y de finanzas entienden la asignación de reembolsos parciales.
• El comportamiento de los pedidos en preventa, la captura manual y la captura al preparar el pedido se validan, si corresponde.
• Las apps de devolución pueden identificar y reembolsar la transacción de captura de Shop Cash correcta.
• Los equipos de ayuda y de finanzas conocen la diferencia entre el saldo de Shop Cash del cliente, las ofertas de Shop y la actividad de facturación de Shop Campaigns.

Para conocer los requisitos de datos de API y de pedidos, consulta Datos de pedidos de Shop Cash e integraciones externas. Para conocer los requisitos de pago, consulta Conciliación de pagos de Shop Cash.