Επιστροφές Χρημάτων

Επεξεργασία πλήρων και μερικών επιστροφών χρημάτων

Η Cost+ υποστηρίζει τόσο πλήρεις όσο και μερικές επιστροφές χρημάτων σε ολοκληρωμένες παραγγελίες. Οι επιστροφές χρημάτων επεξεργάζονται μέσω της αρχικής μεθόδου πληρωμής που χρησιμοποιήθηκε για τη συναλλαγή.

Δημιουργία Επιστροφής Χρημάτων

Στείλτε ένα αίτημα POST στο /v1/orders/\{id\}/refunds/ για να ξεκινήσετε μια επιστροφή χρημάτων σε μια ολοκληρωμένη παραγγελία.

Αίτημα

{
  "amount": 100,
  "description": "Refund for item",
  "merchant_order_id": "refund-001"
}

Το πεδίο amount είναι σε λεπτά. Για να επιστρέψετε 1,00 EUR, ορίστε amount σε 100. Για πλήρη επιστροφή χρημάτων, ορίστε το ποσό στο πλήρες ποσό παραγγελίας.

Πεδία Αιτήματος

Πεδίο	Απαιτούμενο	Περιγραφή
`amount`	Ναι	Ποσό επιστροφής χρημάτων σε λεπτά
`description`	Όχι	Λόγος για την επιστροφή χρημάτων
`merchant_order_id`	Όχι	Το δικό σας αναγνωριστικό αναφοράς για την επιστροφή χρημάτων
`extra`	Όχι	Πρόσθετα μεταδεδομένα ως αντικείμενο κλειδιού-τιμής

Απόκριση

Το API επιστρέφει το αντικείμενο επιστροφής χρημάτων με την τρέχουσα κατάστασή του:

{
  "id": "ref_abc123...",
  "created": "2024-01-02T10:00:00.000000+00:00",
  "modified": "2024-01-02T10:00:00.000000+00:00",
  "amount": 100,
  "currency": "EUR",
  "status": "pending",
  "description": "Refund for item",
  "merchant_order_id": "refund-001",
  "extra": null
}

Πεδία Απόκρισης

Πεδίο	Περιγραφή
`id`	Μοναδικό αναγνωριστικό για την επιστροφή χρημάτων
`created`	Χρονοσήμανση δημιουργίας της επιστροφής χρημάτων
`modified`	Χρονοσήμανση τελευταίας ενημέρωσης της επιστροφής χρημάτων
`amount`	Ποσό επιστροφής χρημάτων σε λεπτά
`currency`	Νόμισμα της επιστροφής χρημάτων (ταιριάζει με το νόμισμα παραγγελίας)
`status`	Τρέχουσα κατάσταση επιστροφής χρημάτων (`pending`, `completed`, `failed`)
`description`	Λόγος για την επιστροφή χρημάτων
`merchant_order_id`	Το αναγνωριστικό αναφοράς σας
`extra`	Πρόσθετα μεταδεδομένα

Πλήρεις έναντι Μερικών Επιστροφών Χρημάτων

Πλήρης επιστροφή χρημάτων: Ορίστε το amount στο συνολικό ποσό παραγγελίας. Ολόκληρη η πληρωμή επιστρέφεται στον πελάτη.
Μερική επιστροφή χρημάτων: Ορίστε το amount σε λιγότερο από το συνολικό ποσό παραγγελίας. Μόνο το καθορισμένο ποσό επιστρέφεται.

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

{
  "amount": 500,
  "description": "Partial refund - damaged item"
}

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

Χρησιμοποιήστε το πεδίο merchant_order_id για να συνδέσετε τις επιστροφές χρημάτων με τα εσωτερικά σας συστήματα. Αυτό είναι ιδιαίτερα χρήσιμο όταν εκδίδετε πολλαπλές μερικές επιστροφές χρημάτων στην ίδια παραγγελία.

Καταστάσεις Επιστροφής Χρημάτων

Κατάσταση	Περιγραφή
`pending`	Η επιστροφή χρημάτων ξεκίνησε και βρίσκεται σε επεξεργασία.
`completed`	Η επιστροφή χρημάτων ολοκληρώθηκε επιτυχώς. Τα χρήματα θα επιστραφούν στον πελάτη.
`failed`	Η επιστροφή χρημάτων δεν μπόρεσε να επεξεργαστεί. Επικοινωνήστε με την υποστήριξη Cost+.

Ο χρόνος που χρειάζεται για να εμφανιστεί το ποσό επιστροφής στον λογαριασμό του πελάτη εξαρτάται από τη μέθοδο πληρωμής και την τράπεζα του πελάτη. Οι επιστροφές πιστωτικής κάρτας χρειάζονται συνήθως 5-10 εργάσιμες ημέρες.

Έλεγχος Ποσού Διαθέσιμου για Επιστροφή

Πριν εκδώσετε μερική επιστροφή χρημάτων, μπορείτε να ελέγξετε πόσο είναι διαθέσιμο:

curl -u YOUR_API_KEY: \
  "https://api.costplus.online/v1/orders/{order_id}/?fields[]=amount_details"

Το πεδίο refundable στην απόκριση δείχνει το μέγιστο ποσό που μπορείτε να επιστρέψετε.

Σχετικά Endpoints

Δημιουργία Επιστροφής Χρημάτων — έκδοση πλήρους ή μερικής επιστροφής χρημάτων σε ολοκληρωμένη παραγγελία
Λίστα Επιστροφών Χρημάτων — ανάκτηση όλων των επιστροφών χρημάτων για μια παραγγελία

Επιστροφές Χρημάτων

On this page