Δεδομένα παραγγελιών Shop Cash και ενσωματώσεις τρίτων

Όταν ένας πελάτης χρησιμοποιεί το Shop Cash σε μια παραγγελία, το Shop Cash αντιμετωπίζεται ως μέθοδος πληρωμής. Δεν αποτελεί έκπτωση, δωροκάρτα ή πιστωτικό ποσό καταστήματος. Τυχόν εναπομείναν υπόλοιπο της παραγγελίας πληρώνεται με Shop Pay ή Shop Pay Installments.

Για παράδειγμα, εάν ένας πελάτης χρησιμοποιήσει 25 USD σε Shop Cash σε μια παραγγελία 100 USD, τότε η παραγγελία περιλαμβάνει μια πληρωμή Shop Cash για 25 USD και μια πληρωμή Shop Pay για 75 USD. Τα δεδομένα της παραγγελίας σας μπορεί να περιλαμβάνουν περισσότερες από μία μεθόδους πληρωμής για την ίδια παραγγελία.

Το Shop Cash εμφανίζεται ως συναλλαγή παραγγελίας με την τιμή πύλης shop_cash, όπου είναι διαθέσιμες οι τιμές πύλης. Η συναλλαγή Shop Cash ακολουθεί τον τυπικό κύκλο ζωής μιας συναλλαγής, όπως εξουσιοδότηση, οριστικοποίηση, ακύρωση και επιστροφή χρημάτων. Το Shop Cash δεν χρησιμοποιεί συνδυασμένο είδος συναλλαγής πώλησης.

Εάν ο πελάτης χρησιμοποιεί επίσης μια προσφορά Shop από τα Shop Campaigns, τότε η αξία που χρηματοδοτείται από την καμπάνια περιλαμβάνεται στο ίδιο ποσό συναλλαγής παραγγελίας shop_cash. Το μέρος από το υπόλοιπο του αγοραστή και το μέρος που χρηματοδοτείται από την καμπάνια δεν αναπαριστώνται ως ξεχωριστές συναλλαγές παραγγελίας. Από τον Ιανουάριο του 2026, τα κόστη καμπάνιας χρεώνονται στον λογαριασμό σας στο Shopify, αντί να αφαιρούνται από τις εισερχόμενες πληρωμές σας, επομένως οι συναλλαγές χρέωσης καμπάνιας στη δραστηριότητα εισερχόμενων πληρωμών ισχύουν μόνο για καμπάνιες που εκτελέστηκαν πριν από αυτήν την ημερομηνία. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα Χρεώσεις, Shop Campaigns και Shop Cash.

Τα συστήματα τρίτων που εισάγουν παραγγελίες, συναλλαγές, πληρωμές, διεκπεραιώσεις, επιστροφές χρημάτων ή επιστροφές προϊόντων πρέπει να αναγνωρίζουν το Shop Cash ως μέθοδο πληρωμής. Εάν ένα σύστημα δεν αναγνωρίζει το Shop Cash, τότε οι παραγγελίες που περιλαμβάνουν Shop Cash μπορεί να αποτύχουν κατά την εισαγωγή, να εισαχθούν με ελλιπή δεδομένα πληρωμής ή να απαιτήσουν μη αυτόματη αντιστοίχιση.

Ελέγξτε τις ακόλουθες απαιτήσεις με τον πάροχο του συστήματος τρίτου κατασκευαστή:

• Το σύστημα μπορεί να υποστηρίξει περισσότερες από μία μεθόδους πληρωμής σε μία παραγγελία.
• Το σύστημα μπορεί να αντιστοιχίσει το shop_cash ως μέθοδο πληρωμής.
• Το σύστημα δεν αντιμετωπίζει το Shop Cash ως έκπτωση, δωροκάρτα ή πιστωτικό ποσό καταστήματος.
• Το σύστημα αποθηκεύει το αναγνωριστικό της συναλλαγής παραγγελίας για κάθε εξουσιοδότηση, οριστικοποίηση, ακύρωση και επιστροφή χρημάτων του Shop Cash.
• Το σύστημα αποθηκεύει την πλήρη τιμή εξουσιοδότησης Shop Cash χωρίς να την περικόπτει, εάν η τιμή περιλαμβάνεται στα δεδομένα που εισάγει το σύστημα.
• Το σύστημα αντιμετωπίζει τις τιμές εξουσιοδότησης ως αδιαφανείς συμβολοσειρές και δεν τις αναλύει, αποκωδικοποιεί, κανονικοποιεί, κατακερματίζει, ούτε εξάγει νόημα από αυτές.
• Το σύστημα μπορεί να επεξεργαστεί επιστροφές χρημάτων που επιστρέφουν ποσά τόσο στο Shop Pay όσο και στο Shop Cash.
• Το σύστημα μπορεί να κάνει αντιπαραβολή των συναλλαγών εισερχόμενων πληρωμών Shop Cash ξεχωριστά από τις συναλλαγές πληρωμής με κάρτα.
• Το σύστημα δεν υποθέτει ότι οι συναλλαγές επιστρέφονται με συγκεκριμένη σειρά.

Εάν το σύστημα τρίτου κατασκευαστή υποθέτει ότι κάθε παραγγελία έχει μόνο μία μέθοδο πληρωμής, επικοινωνήστε με τον πάροχο πριν επεξεργαστείτε παραγγελίες Shop Cash μέσω αυτού του συστήματος.

Η τιμή εξουσιοδότησης σε μια συναλλαγή Shop Cash είναι μια αδιαφανής συμβολοσειρά μεταβλητού μήκους. Δεν είναι ένας σύντομος κωδικός εξουσιοδότησης κάρτας και δεν είναι αναγνώσιμη από ανθρώπους.

Εάν το ERP, το OMS ή άλλο σύστημα τρίτου κατασκευαστή εισάγει τιμές εξουσιοδότησης Shop Cash, αποθηκεύστε την πλήρη τιμή ακριβώς όπως παρέχεται. Χρησιμοποιήστε ένα πεδίο κειμένου μεταβλητού μήκους ή χωρίς περιορισμό μεγέθους, όπου είναι δυνατόν.

Όταν το σύστημά σας αποθηκεύει τιμές εξουσιοδότησης Shop Cash, ακολουθήστε αυτές τις οδηγίες:

• Μην περικόπτετε την τιμή σε σύντομο, σταθερό μήκος, όπως 50 ή 100 χαρακτήρες.
• Μην αναλύετε και μην εξάγετε νόημα από οποιοδήποτε τμήμα της τιμής.
• Μην χρησιμοποιείτε την τιμή εξουσιοδότησης για την αναγνώριση συναλλαγών για λειτουργίες API οριστικοποίησης, ακύρωσης ή επιστροφής χρημάτων.

Οι περικομμένες τιμές εξουσιοδότησης ενδέχεται να προκαλέσουν αποτυχία στις εισαγωγές συστημάτων τρίτων ή στη μεταγενέστερη επεξεργασία από ERP και OMS.

Για να υποστηρίξετε οριστικοποιήσεις, ακυρώσεις και επιστροφές χρημάτων μέσω του Admin API, αποθηκεύστε τα αναγνωριστικά συναλλαγών παραγγελίας και τις σχέσεις γονικών συναλλαγών. Οι λειτουργίες οριστικοποίησης και ακύρωσης του Admin API προσδιορίζουν τη συναλλαγή εξουσιοδότησης με το parentTransactionId. Οι λειτουργίες επιστροφής χρημάτων προσδιορίζουν την επιστρεπτέα συναλλαγή οριστικοποίησης με το parentId.

Όταν μια εφαρμογή ή ενσωμάτωση εκδίδει μια επιστροφή χρημάτων Shop Cash μέσω του API, η επιστροφή χρημάτων πρέπει να έχει ως γονική τη συναλλαγή οριστικοποίησης του Shop Cash, και όχι τη συναλλαγή εξουσιοδότησης του Shop Cash. Οι επιστροφές χρημάτων σε σχέση με τη συναλλαγή εξουσιοδότησης απορρίπτονται.

Οι εφαρμογές επιστροφής χρημάτων και οι χειριστές webhook πρέπει να αναγνωρίζουν την επιστρεπτέα συναλλαγή οριστικοποίησης του Shop Cash, να υπολογίζουν το εναπομένον επιστρεπτέο ποσό για αυτήν την οριστικοποίηση και να δημιουργούν την επιστροφή χρημάτων με βάση το αναγνωριστικό της συναλλαγής οριστικοποίησης.

Όταν χρησιμοποιείτε το Admin API, τις εξαγωγές παραγγελιών, τις εξαγωγές εισερχόμενων πληρωμών ή τις εξαγωγές εφαρμογών τρίτου κατασκευαστή, χειριστείτε το Shop Cash ως δεδομένα πληρωμής. Ανάλογα με την εξαγωγή ή τον πόρο API που χρησιμοποιείτε, οι πληροφορίες του Shop Cash μπορούν να αναπαρασταθούν μέσω δεδομένων μεθόδου πληρωμής, πύλης, συναλλαγής παραγγελίας, συναλλαγής εισερχόμενης πληρωμής και επιστροφής χρημάτων.

Όταν δημιουργείτε ή ενημερώνετε μια ενσωμάτωση, αποθηκεύστε τις ακόλουθες πληροφορίες για τις παραγγελίες που περιλαμβάνουν Shop Cash:

• Το αναγνωριστικό παραγγελίας και το όνομα παραγγελίας.
• Την τιμή της μεθόδου πληρωμής ή της πύλης, όπως shop_cash, όπου είναι διαθέσιμη.
• Τα αναγνωριστικά συναλλαγής παραγγελίας για κάθε συναλλαγή πληρωμής.
• Το είδος και την κατάσταση της συναλλαγής, όπως έγκριση, δέσμευση, επιστροφή χρημάτων ή ακύρωση.
• Το ποσό και το νόμισμα της συναλλαγής.
• Τις σχέσεις γονικής συναλλαγής, όταν είναι διαθέσιμες.
• Τα αναγνωριστικά πληρωμής, όπου είναι διαθέσιμα.
• Τις πλήρεις τιμές έγκρισης, εάν τις εισάγει το σύστημά σας.
• Τα αναγνωριστικά εισερχόμενης πληρωμής και τα αναγνωριστικά συναλλαγής υπολοίπου όταν κάνετε αντιπαραβολή εισερχόμενων πληρωμών.
• Τα αναγνωριστικά συναλλαγής επιστροφής χρημάτων, όταν κάνετε αντιπαραβολή επιστροφών.

Για λεπτομέρειες σχετικά με τα διαθέσιμα πεδία του Admin API, ανατρέξτε στην τεκμηρίωση για προγραμματιστές για τη συναλλαγή παραγγελίας του Admin API. Αποφύγετε να βασίζεστε σε καταργημένα πεδία, όπως το OrderTransaction.authorizationCode, για νέες ενσωματώσεις.

Το ακόλουθο απλοποιημένο παράδειγμα δείχνει μια παραγγελία αξίας 100 USD, η οποία πληρώθηκε με 75 USD μέσω του Shopify Payments και με 25 USD μέσω του Shop Cash. Οι τιμές είναι μόνο ενδεικτικές.

{
  "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
    }
  ]
}

Το Shop Cash μπορεί να μοιάζει με άλλες αξίες πληρωμής ή προσφοράς, αλλά τα συστήματά σας θα πρέπει να χειρίζονται κάθε αξία ξεχωριστά:

Προτού βασιστείτε σε ένα σύστημα τρίτου κατασκευαστή για παραγγελίες που περιλαμβάνουν Shop Cash, επιβεβαιώστε τις ακόλουθες απαιτήσεις:

• Το Shop Cash αντιστοιχίζεται ως μέθοδος πληρωμής.
• Οι παραγγελίες με Shop Cash και Shop Pay εισάγονται και με τις δύο μεθόδους πληρωμής.
• Η λογική της μεθόδου πληρωμής δεν προϋποθέτει μόνο μία μέθοδο πληρωμής ανά παραγγελία.
• Οι τιμές έγκρισης αποθηκεύονται ως μεγάλες αδιαφανείς συμβολοσειρές και δεν περικόπτονται.
• Η λογική επιστροφής χρημάτων μπορεί να επιστρέψει τα χρήματα στη σωστή συναλλαγή δέσμευσης.
• Η λογική επιστροφής χρημάτων μπορεί να επιστρέψει τα κεφάλαια στις σωστές μεθόδους πληρωμής.
• Η αντιπαραβολή εισερχόμενων πληρωμών μπορεί να λάβει υπόψη τους τύπους συναλλαγών πιστωτικού ποσού, επιστροφής χρημάτων και καμπάνιας του Shop Cash.
• Οι ροές εργασίας διεκπεραίωσης, λογιστικής και επιστροφών δεν αντιμετωπίζουν το Shop Cash ως έκπτωση.

Εάν χρησιμοποιείτε πολλαπλά συστήματα, τότε ολοκληρώστε αυτόν τον έλεγχο για κάθε σύστημα που λαμβάνει δεδομένα παραγγελίας, συναλλαγής, εισερχόμενης πληρωμής, διεκπεραίωσης, επιστροφής χρημάτων ή επιστροφής.