Préparer vos systèmes pour Shop Cash

Avant de lancer les flux de travail Shop Cash avec des systèmes tiers, vérifiez les exigences suivantes :

• Vos systèmes ERP, de gestion des commandes (OMS), de traitement des commandes, de comptabilité et de retours peuvent accepter plus d’un moyen de paiement par commande.
• shop_cash est mappé en tant que moyen de paiement là où les valeurs de passerelle sont disponibles.
• Shop Cash n’est pas traité comme une réduction, une carte-cadeau ou un crédit en magasin.
• La valeur d’autorisation est stockée sous forme de chaîne de caractères opaque de longueur variable d’au moins 1 024 caractères. Si possible, utilisez un champ de texte non délimité.
• Les saisies, les annulations et les remboursements sont identifiés par l’ID de transaction plutôt que par la valeur d’autorisation. Les opérations de saisie et d’annulation de l’Admin API utilisent parentTransactionId, et les opérations de remboursement utilisent parentId.
• Vos systèmes n’analysent, ne décodent, ne normalisent, ne hachent et ne tronquent pas les valeurs d’autorisation Shop Cash.
• Vos systèmes peuvent gérer les versements groupés, où une seule ligne shop_cash_credit peut représenter plusieurs commandes.
• Votre flux de travail de rapprochement ne suppose pas qu’une commande équivaut à une seule ligne de versement.
• Votre flux de travail de rapprochement peut gérer le règlement de la partie Shop Cash et de la partie par carte ou par Paiement en plusieurs fois avec Shop Pay sur des versements distincts.
• Votre flux de travail de remboursement peut traiter des remboursements partiels répartis entre une carte ou le Paiement en plusieurs fois avec Shop Pay, et Shop Cash.
• Les applications de remboursement peuvent rembourser la transaction de saisie Shop Cash, et non la transaction d’autorisation.
• Si vous avez utilisé Shop Campaigns avant janvier 2026, votre flux de travail financier traite la ligne historique shop_cash_campaign_billing_debit et les lignes de facturation de campagne associées séparément des revenus de commande. À partir de janvier 2026, les coûts de campagne sont plutôt facturés sur votre facture Shopify.

Les tests de Shop Cash présentent des limites, car Shop Cash dépend des comptes d’acheteur Shop, des soldes Shop Cash, de Shopify Payments et de l’infrastructure de règlement Shop Cash.

La manière la plus fiable de valider une intégration d’entreprise de bout en bout consiste à passer une commande de production de faible valeur via Shop, puis à la rembourser. Cela crée des transactions de commande, des données de saisie, une activité de versement, des transactions de remboursement et une activité de débit de remboursement de type production qui transitent par l’interface administrateur Shopify, les données de l’Admin API, les exportations de versements et les données de l’API de versements.

Les boutiques de développement peuvent aider à valider la structure de certains champs d’API et la logique de mappage, mais elles ne permettent pas de tester de manière fiable l’intégralité du flux de paiement issu de Shop, du solde de l’acheteur et du règlement. Le mode de test et la passerelle fictive ne créent pas de lignes de versement Shop Cash de type production, car ils n’utilisent pas de flux de règlement Shopify Payments en direct.

Vous pouvez généralement tester les flux de travail suivants avec une commande de production de faible valeur initiée depuis Shop :

• L’ingestion des commandes pour une commande à plusieurs moyens de paiement qui inclut Shop Cash et Shop Pay ou le Paiement en plusieurs fois avec Shop Pay.
• Le mappage ERP ou OMS pour shop_cash.
• Le stockage de la valeur d’autorisation Shop Cash complète.
• Les remboursements complets et partiels de la commande.
• L’ingestion de l’activité de versement shop_cash_refund_debit.
• Le rapprochement des versements pour les crédits Shop Cash.
• Le comportement de pré-commande ou de saisie au moment du traitement des commandes, si votre boutique utilise la saisie différée.
• La gestion des applications de retour pour les commandes comportant plusieurs moyens de paiement.

Lorsque vous effectuez des tests en production, utilisez une commande de faible valeur et suivez les procédures internes de commande de test et de remboursement de votre boutique.

Contactez l’Assistance Shopify si vous avez besoin d’aide pour l’un des scénarios suivants :

• L’examen de la disponibilité de Shop Cash pour un marché en cours de déploiement.
• L’analyse d’une saisie ou d’un remboursement Shop Cash ayant échoué.
• L’analyse d’une transaction de versement Shop Cash manquante après votre cadence de versement normale, plus un cycle de versement supplémentaire.
• La vérification visant à déterminer si une autorisation Shop Cash annulée ou expirée peut être de nouveau autorisée.
• La planification d’un lancement pour un flux de travail complexe impliquant un ERP, un OMS, une pré-commande ou le traitement des commandes.

Avant d’augmenter le volume de commandes Shop Cash, effectuez les vérifications suivantes :

• Le mappage des moyens de paiement de l’ERP et de l’OMS est déployé et vérifié pour shop_cash.
• Un exemple de commande Shop Cash est ingéré de bout en bout, y compris les transactions d’autorisation et de saisie.
• Un exemple de crédit de versement Shop Cash fait l’objet d’un rapprochement avec la ou les commandes sources.
• Un exemple de remboursement Shop Cash est traité et rapproché du débit de remboursement.
• Les lignes de versement Shop Cash groupées sont prises en charge ou font l’objet d’un processus de rapprochement manuel.
• L’affectation des remboursements partiels est comprise par vos équipes d’assistance et des finances.
• Le comportement de pré-commande, de saisie manuelle et de saisie au moment du traitement des commandes est validé, le cas échéant.
• Les applications de retour peuvent identifier et rembourser la transaction de saisie Shop Cash correspondante.
• Les équipes d’assistance et des finances connaissent la différence entre le solde Shop Cash du client, les offres Shop et l’activité de facturation de Shop Campaigns.

Pour connaître les exigences relatives aux API et aux données de commande, consultez la section Données de commande Shop Cash et intégrations tierces. Pour les exigences relatives aux versements, consultez la section Rapprochement des versements Shop Cash.