Prepara i tuoi sistemi per Shop Cash

Prima di lanciare i flussi di lavoro Shop Cash con sistemi di terze parti, verifica i seguenti requisiti:

• I sistemi ERP, OMS, di evasione, contabilità e di reso possono accettare più di un metodo di pagamento per un ordine.
• shop_cash è mappato come metodo di pagamento in cui sono disponibili i valori del gateway.
• Shop Cash non viene trattato come sconto, buono regalo o credito in negozio.
• Il valore di autorizzazione è memorizzato come una stringa opaca a lunghezza variabile di almeno 1024 caratteri. Se possibile, usa un campo di testo illimitato.
• Acquisizioni, annullamenti e rimborsi vengono identificati tramite ID transazione anziché tramite il valore di autorizzazione. Le operazioni di acquisizione e annullamento delle Admin API usano parentTransactionId e le operazioni di rimborso usano parentId.
• I sistemi non analizzano, decodificano, normalizzano, eseguono l’hashing o troncano i valori di autorizzazione Shop Cash.
• I sistemi possono gestire gli accrediti raggruppati, in cui una singola riga shop_cash_credit può rappresentare più ordini.
• Il flusso di lavoro di riconciliazione non presuppone che a un ordine corrisponda una sola riga di accredito.
• Il flusso di lavoro di riconciliazione può gestire la liquidazione della quota di Shop Cash e della quota relativa a carta o Shop Pay Installments su accrediti diversi.
• Il flusso di lavoro dei rimborsi può elaborare rimborsi parziali suddividendoli tra carta o Shop Pay Installments e Shop Cash.
• Le app per i rimborsi possono rimborsare la transazione di acquisizione Shop Cash, non la transazione di autorizzazione.
• Se hai lanciato Shop Campaigns prima di gennaio 2026, il flusso di lavoro finanziario gestisce lo storico shop_cash_campaign_billing_debit e le relative righe di fatturazione della campagna separatamente dalle entrate degli ordini. Da gennaio 2026 in poi, i costi della campagna vengono invece addebitati sulla tua fattura Shopify.

I test di Shop Cash presentano dei limiti, poiché Shop Cash dipende dagli account acquirente di Shop, dai saldi Shop Cash, da Shopify Payments e dall’infrastruttura di liquidazione Shop Cash.

Il modo più affidabile per convalidare un’integrazione aziendale end-to-end è effettuare un ordine di basso valore in produzione tramite Shop e poi rimborsarlo. Questa procedura crea transazioni di ordini, dati di acquisizione, attività di accredito, transazioni di rimborso e attività di addebito del rimborso del tutto simili a quelle di produzione, che passano attraverso il pannello di controllo Shopify, i dati delle Admin API, le esportazioni degli accrediti e i dati API degli accrediti.

I development store possono aiutare a convalidare le logiche di mappatura e le forme di alcuni campi API, ma non testano in modo affidabile l’intero flusso di check-out originato su Shop, il saldo dell’acquirente e il flusso di liquidazione. La modalità di prova e il gateway Bogus non creano righe di accredito Shop Cash simili a quelle di produzione perché non utilizzano un flusso di liquidazione Shopify Payments live.

Di solito puoi testare i seguenti flussi di lavoro con un ordine di produzione di basso valore avviato da Shop:

• Inserimento di un ordine con metodo di pagamento multiplo che include Shop Cash e Shop Pay o Shop Pay Installments.
• Mappatura ERP o OMS per shop_cash.
• Archiviazione del valore di autorizzazione completo di Shop Cash.
• Rimborsi completi e parziali a fronte dell’ordine.
• Inserimento dell’attività di accredito shop_cash_refund_debit.
• Riconciliazione degli accrediti per i crediti Shop Cash.
• Comportamento di preordine o di acquisizione all’evasione, se il tuo negozio utilizza l’acquisizione differita.
• Gestione delle app di reso per gli ordini con più di un metodo di pagamento.

Durante i test in produzione, utilizza un ordine di basso valore e segui le procedure interne del negozio per gli ordini di prova e i rimborsi.

Contatta l’Assistenza Shopify se hai bisogno di aiuto in uno dei seguenti scenari:

• Verifica della disponibilità di Shop Cash per un mercato in fase di rollout.
• Indagine su un’acquisizione o un rimborso Shop Cash non andato a buon fine.
• Indagine su una transazione di accredito Shop Cash mancante al termine della normale frequenza di accredito più un ciclo di accredito aggiuntivo.
• Verifica della possibilità di autorizzare nuovamente un’autorizzazione Shop Cash annullata o scaduta.
• Pianificazione di un lancio per un flusso di lavoro complesso relativo a ERP, OMS, preordine o evasione.

Prima di aumentare il volume degli ordini Shop Cash, completa le seguenti verifiche:

• La mappatura del metodo di pagamento per ERP e OMS è implementata e verificata per shop_cash.
• Un ordine Shop Cash di esempio viene inserito end-to-end, comprese le transazioni di autorizzazione e acquisizione.
• Un credito di accredito Shop Cash di esempio viene riconciliato con l’ordine o gli ordini di origine.
• Un rimborso Shop Cash di esempio viene elaborato e riconciliato con l’addebito del rimborso.
• Le righe di accredito Shop Cash raggruppate sono supportate o prevedono un processo di riconciliazione manuale.
• L’allocazione dei rimborsi parziali è compresa dai team finanziario e di assistenza.
• Il comportamento per il preordine, l’acquisizione manuale e l’acquisizione all’evasione è convalidato, se applicabile.
• Le app dei resi possono identificare e rimborsare la corretta transazione di acquisizione Shop Cash.
• I team finanziario e di assistenza conoscono la differenza tra il saldo Shop Cash del cliente, le offerte Shop e l’attività di fatturazione di Shop Campaigns.

Per i requisiti delle API e dei dati dell’ordine, fai riferimento a Dati dell’ordine Shop Cash e integrazioni di terze parti. Per i requisiti degli accrediti, fai riferimento a Riconciliazione degli accrediti Shop Cash.