Datos do pedido de Shop Cash e integracións de terceiros
Shop Cash rexístrase nos pedidos como método de pagamento. Podes usar os datos do pedido de Shop Cash para preparar sistemas de terceiros, revisar os pedidos que inclúen máis dun método de pagamento e conciliar a actividade de Shop Cash con pagamentos e reembolsos.
Se a túa tenda usa un sistema de planificación de recursos empresariais (ERP), un sistema de xestión de pedidos (OMS), un sistema de preparación de pedidos, unha aplicación de devolucións, un sistema de contabilidade ou outra aplicación de terceiros, confirma que o sistema poida importar e procesar os datos do pedido de Shop Cash antes de confiar nel para os fluxos de traballo de preparación de pedidos, contabilidade ou conciliación.
Nesta páxina
- Como se rexistra Shop Cash nos pedidos
- Requisitos dos sistemas de terceiros para Shop Cash
- Valores de autorización
- Requisitos das transaccións de reembolso
- Consideracións da API e a exportación
- Exemplo de estrutura de transaccións de pedidos
- En que se diferenza Shop Cash de valores de pedido similares
- Lista de comprobación de integración de Shop Cash
Como se rexistra Shop Cash nos pedidos
Cando un cliente usa Shop Cash nun pedido, Shop Cash trátase como un método de pagamento. Non é un desconto, tarxeta de agasallo nin crédito da tenda. Calquera saldo do pedido restante págase con Shop Pay ou Shop Pay Installments.
Por exemplo, se un cliente usa 25 USD en Shop Cash nun pedido de 100 USD, o pedido incluirá un pagamento con Shop Cash por 25 USD e un pagamento con Shop Pay por 75 USD. Os datos do pedido poden incluír máis dun método de pagamento para o mesmo pedido.
Shop Cash aparece como unha transacción do pedido co valor da pasarela shop_cash nos lugares onde os valores da pasarela estean dispoñibles. A transacción de Shop Cash segue o ciclo de vida da transacción estándar, como a autorización, a captura, a anulación e o reembolso. Shop Cash non utiliza un tipo de transacción de venda combinada.
Se o cliente tamén usa unha oferta de Shop dunha Shop Campaign, o valor financiado pola campaña incluirase no mesmo importe da transacción do pedido shop_cash. As partes do saldo do comprador e financiadas pola campaña non se representan como transaccións de pedidos separadas. A partir de xaneiro de 2026, os custos das campañas cóbranse na factura de Shopify en lugar de deducirse dos pagamentos, polo que as transaccións de facturación da campaña na actividade de pagamentos aplícanse só ás campañas que se executaron antes desa data. Para obter máis información, consulta Cargos, Shop Campaigns e Shop Cash.
Requisitos dos sistemas de terceiros para Shop Cash
Os sistemas de terceiros que importan pedidos, transaccións, pagamentos, preparacións de pedidos, reembolsos ou devolucións teñen que recoñecer Shop Cash como método de pagamento. Se un sistema non recoñece Shop Cash, pode que os pedidos que inclúen Shop Cash non se importen, que se importen con datos de pagamento incompletos ou que requiran asignación manual.
Revisa os seguintes requisitos co teu provedor do sistema de terceiros:
- O sistema pode ser compatible con máis dun método de pagamento por pedido.
- O sistema pode asignar
shop_cashcomo método de pagamento. - O sistema non trata Shop Cash como un desconto, tarxeta de agasallo nin crédito da tenda.
- O sistema almacena o ID da transacción do pedido para cada autorización, captura, anulación e reembolso de Shop Cash.
- O sistema almacena o valor completo da autorización de Shop Cash sen truncalo, se o valor está incluído nos datos que o sistema importa.
- O sistema trata os valores de autorización como cadeas opacas e non os analiza, descodifica, normaliza, nin lles aplica funcións hash ou deduce ningún significado deles.
- O sistema pode procesar os reembolsos que devolven fondos tanto a Shop Pay como a Shop Cash.
- O sistema pode conciliar as transaccións dos pagamentos de Shop Cash de forma separada ás transaccións de pagamento con tarxeta.
- O sistema non asume que as transaccións se devolvan nunha orde específica.
Se o teu sistema de terceiros asume que cada pedido ten só un método de pagamento, contacta co provedor antes de procesar pedidos de Shop Cash mediante ese sistema.
Valores de autorización
O valor de autorización nunha transacción de Shop Cash é unha cadea opaca e de lonxitude variable. Non é un código de autorización de tarxeta curto nin lexible para os humanos.
Se o teu ERP, OMS ou outro sistema de terceiros importa valores de autorización de Shop Cash, almacena o valor completo exactamente como se proporciona. Usa un campo de texto sen límite ou de lonxitude variable cando sexa posible.
Cando o teu sistema almacene os valores de autorización de Shop Cash, sigue estas pautas:
- Non trunques o valor a unha lonxitude curta e fixa, como de 50 ou 100 caracteres.
- Non analices nin deduzas ningún significado de ningunha parte do valor.
- Non uses o valor de autorización para identificar transaccións nas operacións da API de captura, anulación ou reembolso.
Os valores de autorización truncados poden causar que fallen as importacións de terceiros ou o procesamento posterior no ERP e no OMS.
Para ser compatible coas capturas, as anulacións e os reembolsos a través da Admin API, almacena os ID das transaccións do pedido e as relacións coas transaccións principais. As operacións de captura e anulación da Admin API identifican a transacción de autorización con parentTransactionId. As operacións de reembolso identifican a transacción de captura reembolsable con parentId.
Requisitos das transaccións de reembolso
Cando unha aplicación ou integración emite un reembolso de Shop Cash a través da API, o reembolso debe estar subordinado á transacción de captura de Shop Cash, non á transacción de autorización de Shop Cash. Os reembolsos sobre a transacción de autorización rexeitaranse.
As aplicacións de reembolso e os xestores de webhook deben identificar a transacción de captura de Shop Cash reembolsable, calcular o importe reembolsable que queda para esa captura e crear o reembolso co ID da transacción de captura.
Consideracións da API e a exportación
Cando uses a Admin API, exportacións de pedidos, exportacións de pagamentos ou exportacións de aplicacións de terceiros, trata Shop Cash como datos de pagamento. Dependendo do recurso de exportación ou da API que utilices, a información de Shop Cash pódese representar a través dos datos de método de pagamento, pasarela, transacción de pedido, transacción de pagamento e reembolso.
Cando deseñes ou actualices unha integración, almacena a seguinte información para os pedidos que inclúan Shop Cash:
- O ID e o nome do pedido.
- O valor do método de pagamento ou pasarela, como
shop_cashcando estea dispoñible. - Os ID das transaccións do pedido para cada transacción de pagamento.
- O tipo e estado da transacción, como autorización, captura, reembolso ou anulación.
- O importe e a moeda da transacción.
- As relacións con transaccións principais, cando estean dispoñibles.
- Os ID de pagamento, cando estean dispoñibles.
- Os valores de autorización completos, se o teu sistema os importa.
- Os ID de pagamento e ID de transaccións de saldo ao conciliar os pagamentos.
- Os ID das transaccións de reembolso ao conciliar as devolucións.
Para obter información sobre os campos dispoñibles da Admin API, consulta a documentación para desenvolvedores de transacción de pedido da Admin API. Evita depender de campos obsoletos como OrderTransaction.authorizationCode para novas integracións.
Exemplo da forma de transacción de pedido
O seguinte exemplo simplificado mostra un pedido de 100 USD pago con 75 USD mediante Shopify Payments e 25 USD con Shop Cash. Os valores son só ilustrativos.
{
"transactions": [
{
"kind": "authorization",
"gateway": "shopify_payments",
"status": "success",
"amount": "75.00",
"currency": "USD",
"parent_id": null,
"authorization": "ch_3OabcXYZ..."
},
{
"kind": "authorization",
"gateway": "shop_cash",
"status": "success",
"amount": "25.00",
"currency": "USD",
"parent_id": null,
"authorization": "<long-opaque-variable-length-string>"
},
{
"kind": "capture",
"gateway": "shop_cash",
"status": "success",
"amount": "25.00",
"currency": "USD",
"parent_id": "<shop-cash-authorization-transaction-id>",
"authorization": null
}
]
}En que se diferencia Shop Cash de valores do pedido similares
Shop Cash pode parecer similar a outros valores promocionais ou de pagamento, pero os teus sistemas deben tratar cada valor por separado:
| Valor | Como tratalo |
|---|---|
| Shop Cash | Un método de pagamento que aparece como unha transacción de pedido con shop_cash onde están dispoñibles os valores da pasarela. |
| Tarxeta de agasallo | Un método de pagamento independente. As tarxetas de agasallo non son o mesmo que Shop Cash e non xeran transaccións de pagamento de Shop Cash. |
| Desconto | Unha rebaixa de prezo no pedido ou no artigo de liña. Shop Cash non é un desconto e non reduce o subtotal, os impostos, o envío nin os descontos do pedido. |
| Crédito da tenda | Un método de pagamento independente co seu propio libro maior e comportamento de liquidación. O crédito da tenda non é intercambiable por Shop Cash. |
| Valor de oferta de Shop ou da campaña de Shop | Valor promocional financiado polo comerciante que se pode incluír na mesma transacción de pedido de shop_cash. Os custos da campaña actual cárganse na túa factura de Shopify. A actividade histórica das campañas anterior a xaneiro de 2026 pode aparecer nas transaccións de pagamento da campaña. |
Lista de comprobación da integración de Shop Cash
Antes de depender dun sistema de terceiros para pedidos que inclúen Shop Cash, confirma os seguintes requisitos:
- Shop Cash asígnase como un método de pagamento.
- Os pedidos con Shop Cash e Shop Pay impórtanse con ambos métodos de pagamento.
- A lóxica do método de pagamento non asume un método de pagamento por pedido.
- Os valores de autorización gárdanse como cadeas opacas longas e non se truncan.
- A lóxica de reembolso pode reembolsar a transacción de captura correcta.
- A lóxica de reembolso pode devolver os fondos aos métodos de pagamento correctos.
- A conciliación de pagamentos pode contabilizar os tipos de transaccións de crédito, de reembolso e da campaña de Shop Cash.
- Os fluxos de traballo de preparación de pedidos, contabilidade e devolución non tratan a Shop Cash como un desconto.
Se usas varios sistemas, completa esta revisión para cada sistema que reciba datos de pedido, transacción, pagamento, preparación de pedidos, reembolso ou devolución.