ΠΡΟΓΡΑΜΜΑΤΙΣΤΕΣ

API λειτουργιών λογαριασμού

Διαβάστε το υπόλοιπο, ζητήστε επιστροφές και αναλήψεις, απαντήστε σε αμφισβητήσεις και διαχειριστείτε τις παραδόσεις webhook. Υπογράψτε κάθε αίτημα όπως περιγράφεται στο Έλεγχος ταυτότητας.

Βασικό URLhttps://www.manuellsolutions.com/api/v3
Έκδοση API3.0.0

Δείτε τις λειτουργίες

Περιβάλλον

SandboxLive

Δοκιμάστε χωρίς κίνηση πραγματικών χρημάτων.

Πραγματικές πληρωμές. Απαιτείται live κλειδί.

Υπόλοιπο

Διαβάστε το διαθέσιμο και το αναλήψιμο υπόλοιπό σας.

Το υπόλοιπο sandbox είναι εικονικό. Οι πληρωμές sandbox περνούν αμέσως στο available_amount, χωρίς αναμονή ημερομηνίας αξίας, ώστε να μπορείτε να δοκιμάσετε αμέσως αναλήψεις.

Το live υπόλοιπο προέρχεται από πραγματικές εισπράξεις. Μια πληρωμή περιμένει στο pending_settlement_amount μέχρι την ημερομηνία αξίας της και μετά περνά στο available_amount.

GET/api/v3/balance

Ανάκτηση υπολοίπου

Απόκριση · 200

Σύνοψη υπολοίπου.

`Balance`

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`currency_code`	`string`	Υποχρεωτικό	Ρυθμισμένο βασικό νόμισμα της πλατφόρμας. `USDEURAEDTRY`
`available_amount`	`string`	Υποχρεωτικό	Συνολικό διαθέσιμο υπόλοιπο στα πορτοφόλια συνδέσμων πληρωμής, API και καταστήματος. Ένα κλειδί sandbox διαβάζει αντί γι' αυτό το απομονωμένο εικονικό πορτοφόλι API.
`pending_settlement_amount`	`string`	Υποχρεωτικό	Εισπράχθηκε αλλά δεν έχει ακόμη διακανονιστεί (εκκρεμεί η ημερομηνία αξίας). Είναι πάντα 0.00 με κλειδί sandbox, επειδή οι πληρωμές sandbox δεν περιμένουν ημερομηνία αξίας.
`environment`	`string`	Υποχρεωτικό	Περιβάλλον στο οποίο ανήκουν τα ποσά (το περιβάλλον του κλειδιού υπογραφής). `livesandbox`

Απόκριση · Παράδειγμα

{
  "currency_code": "USD",
  "available_amount": "48200.00",
  "pending_settlement_amount": "250.00",
  "environment": "live"
}

Πιθανά σφάλματα

9000026503

GET/api/v3/balance/withdrawable

Ανάκτηση αναλήψιμου υπολοίπου

Απόκριση · 200

Σύνοψη αναλήψιμου υπολοίπου.

`WithdrawableBalance`

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`currency_code`	`string`	Υποχρεωτικό	Ρυθμισμένο βασικό νόμισμα της πλατφόρμας. `USDEURAEDTRY`
`withdrawable_amount`	`string`	Υποχρεωτικό	Συνολικό διαθέσιμο υπόλοιπο συνδέσμων πληρωμής, API και καταστήματος· το POST /withdrawals μπορεί να χρεώσει μόνο το πορτοφόλι API και εφαρμόζει πρόσθετους ελέγχους. Ένα κλειδί sandbox διαβάζει το απομονωμένο εικονικό πορτοφόλι API.
`can_withdraw`	`boolean`	Υποχρεωτικό	Η τιμή είναι false αν οποιοδήποτε τμήμα του πορτοφολιού είναι αρνητικό.
`environment`	`string`	Υποχρεωτικό	Περιβάλλον στο οποίο ανήκουν τα ποσά (το περιβάλλον του κλειδιού υπογραφής). `livesandbox`

Απόκριση · Παράδειγμα

{
  "currency_code": "USD",
  "withdrawable_amount": "48200.00",
  "can_withdraw": true,
  "environment": "live"
}

Πιθανά σφάλματα

9000026503

Επιστροφές

Ζητήστε επιστροφή ή ακύρωση και παρακολουθήστε την.

Στο live, Το HTTP 202 σημαίνει ότι το αίτημα παραλήφθηκε, όχι ότι η επιστροφή ολοκληρώθηκε. Παρακολουθήστε το αποτέλεσμα μέσω των endpoints κατάστασης: requested, μετά awaiting_provider_manual, μετά completed· ή rejected / cancelled.

Στο sandbox, ένα αίτημα ολοκληρώνεται αμέσως (από προεπιλογή completed). Στείλτε X-CAV-Sandbox-Scenario: rejected για να δοκιμάσετε μια απορριφθείσα επιστροφή.

Τα αιτήματα παραγωγής ελέγχονται. Παρακολουθήστε την αντιστροφή έως completed, rejected ή cancelled. Μόνο ένα ολοκληρωμένο refund στέλνει payment.refunded· παρακολουθήστε ένα void με GET.

POST/api/v3/refundsΑπαιτεί Idempotency-Key

Αίτημα επιστροφής ή ακύρωσης

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`X-CAV-Sandbox-Scenario`	`string · header`	Προαιρετικό	Μόνο για κλειδιά sandbox. Επιλέγει το προσομοιωμένο αποτέλεσμα: `completed` (προεπιλογή) ή `rejected` (χωρίς επίδραση στο εικονικό πορτοφόλι). Ένα live κλειδί που στέλνει αυτή την κεφαλίδα, ή οποιοδήποτε κλειδί που στέλνει άλλη τιμή, λαμβάνει 422 `1000001`. Η κεφαλίδα δεν αποτελεί μέρος της υπογεγραμμένης συμβολοσειράς· αποτελεί όμως μέρος του αποτυπώματος του Idempotency-Key, γι' αυτό η επαναχρησιμοποίηση ενός κλειδιού με άλλο σενάριο επιστρέφει 9000010. Το εφαρμοσμένο σενάριο επιστρέφεται στην κεφαλίδα απόκρισης με το ίδιο όνομα. `completedrejected`

Σώμα αιτήματος

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`payment_code`	`string`	Υποχρεωτικό	Κωδικός της επιτυχώς εξοφλημένης πληρωμής προς αντιστροφή. `maxLength 16`
`operation_type`	`string`	Υποχρεωτικό	Το `refund` επιστρέφει τα χρήματα μιας οριστικοποιημένης πληρωμής· το `void` ακυρώνει μια είσπραξη κάρτας που δεν έχει ακόμη οριστικοποιηθεί. Και τα δύο ανοίγουν αίτημα αντιστροφής (κατάσταση `requested`). Ένας χειριστής το εξετάζει· μόλις εγκριθεί, το ποσό δεσμεύεται από το υπόλοιπό σας και η κατάσταση είναι `awaiting_provider_manual` μέχρι να καταγραφεί η αναφορά επιστροφής του παρόχου (`completed`)· διαφορετικά το αίτημα καταλήγει σε `rejected` ή `cancelled` (η δέσμευση αποδεσμεύεται). Αυτό το endpoint δεν καλεί τον πάροχο. `refundvoid`
`reason`	`string`	Υποχρεωτικό	Γιατί ζητείται η αντιστροφή. `minLength 3maxLength 500`

Σώμα αιτήματος · Παράδειγμα

{
  "payment_code": "ab34cdef",
  "operation_type": "refund",
  "reason": "Customer cancelled the order."
}

Απόκριση · 202

Η αντιστροφή ζητήθηκε. Εξετάζεται και αποστέλλεται χειροκίνητα στον πάροχο. Με κλειδί sandbox επιστρέφεται το προσομοιωμένο αποτέλεσμα (environment sandbox)· μια επανάληψη idempotent επιστρέφει επίσης 202.

`Reversal`

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string`	Υποχρεωτικό	Αναγνωριστικό αιτήματος αντιστροφής (UUID).
`operation`	`string`	Υποχρεωτικό	Τύπος λειτουργίας. `refundvoid`
`status`	`string`	Υποχρεωτικό	Κύκλος ζωής της αντιστροφής: `requested` (αναμονή χειριστή) → `awaiting_provider_manual` (εγκρίθηκε· το ποσό δεσμεύεται μέχρι να καταγραφεί η αναφορά επιστροφής του παρόχου) → `completed`, ή `rejected` / `cancelled` (η δέσμευση αποδεσμεύεται). Τα `processing` και `failed` είναι δεσμευμένες τιμές που σήμερα δεν χρησιμοποιούνται για αντιστροφές πληρωμών. Με κλειδί sandbox η κατάσταση είναι άμεσα οριστική: `completed` (προεπιλογή) ή `rejected`. `requestedprocessingcompletedrejectedfailedawaiting_provider_manualcancelled`
`amount`	`string`	Υποχρεωτικό	Πλήρες ποσό της πληρωμής που αντιστρέφεται, στο νόμισμα της ίδιας της πληρωμής (το ίδιο ποσό και νόμισμα με την πληρωμή και το webhook `payment.refunded`), ως δεκαδική συμβολοσειρά με 2 δεκαδικά. Η κατάσταση requested δεν σημαίνει ότι μετακινήθηκαν χρήματα.
`currency`	`string`	Υποχρεωτικό	Νόμισμα του `amount`: το `currency_code` της πληρωμής που αντιστράφηκε.
`reason`	`string`	Υποχρεωτικό	Αιτιολογία που δώσατε.
`provider_reference`	`string \| null`	Υποχρεωτικό	Αναφορά επιστροφής του παρόχου, που συμπληρώνεται όταν ολοκληρωθεί η επιστροφή στο πραγματικό POS. Στο sandbox επιστρέφεται συνθετική αναφορά που αρχίζει με `SBX-` όταν ολοκληρωθεί η προσομοιωμένη αντιστροφή· δεν είναι εγγραφή του παρόχου.
`provider_refunded_at`	`string · date-time \| null`	Υποχρεωτικό	Πότε καταγράφηκε η επιστροφή του παρόχου (UTC). Είναι null μέχρι τη χειροκίνητη ολοκλήρωση.
`created_at`	`string · date-time`	Υποχρεωτικό	Ώρα του αιτήματος (UTC).
`updated_at`	`string · date-time \| null`	Υποχρεωτικό	Τελευταία αλλαγή κατάστασης (UTC).
`payment_code`	`string \| null`	Υποχρεωτικό	Κωδικός της πληρωμής στην οποία ανήκει αυτή η αντιστροφή (το `code` που επιστράφηκε κατά τη δημιουργία της πληρωμής).
`environment`	`string`	Υποχρεωτικό	Περιβάλλον της αντιστροφής (το περιβάλλον του κλειδιού υπογραφής). `livesandbox`

Απόκριση · Παράδειγμα

{
  "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
  "operation": "refund",
  "status": "requested",
  "amount": "250.00",
  "currency": "USD",
  "reason": "Customer cancelled the order.",
  "provider_reference": "string",
  "provider_refunded_at": "2026-09-26T09:00:00.000Z",
  "created_at": "2026-09-26T09:00:00.000Z",
  "updated_at": "2026-09-26T09:00:00.000Z",
  "payment_code": "ab34cdef",
  "environment": "live"
}

Πιθανά σφάλματα

GET/api/v3/refunds

Λίστα επιστροφών

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`page`	`integer · query`	Προαιρετικό	Αριθμός σελίδας. `minimum 1`
`per_page`	`integer · query`	Προαιρετικό	Στοιχεία ανά σελίδα. `minimum 1maximum 100`
`status`	`string · query`	Προαιρετικό	Φιλτράρισμα ανά κατάσταση. `requestedprocessingawaiting_provider_manualcompletedrejectedfailedcancelled`
`operation_type`	`string · query`	Προαιρετικό	Φιλτράρισμα ανά λειτουργία. `refundvoid`

Απόκριση · 200

Σελιδοποιημένες επιστροφές.

Πεδίο	Τύπος	Περιγραφή
`data`	`Reversal[]`
`meta`	`PaginationMeta`

Απόκριση · Παράδειγμα

{
  "data": [
    {
      "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
      "operation": "refund",
      "status": "requested",
      "amount": "250.00",
      "currency": "USD",
      "reason": "Customer cancelled the order.",
      "provider_reference": "string",
      "provider_refunded_at": "2026-09-26T09:00:00.000Z",
      "created_at": "2026-09-26T09:00:00.000Z",
      "updated_at": "2026-09-26T09:00:00.000Z",
      "payment_code": "ab34cdef",
      "environment": "live"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

Πιθανά σφάλματα

GET/api/v3/refunds/{id}

Ανάκτηση κατάστασης επιστροφής

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string · uuid · path`	Υποχρεωτικό	Το αναγνωριστικό της αντιστροφής.

Απόκριση · 200

Η αντιστροφή.

Αντικείμενο: Reversal (τα πεδία αναφέρονται στο Αίτημα επιστροφής ή ακύρωσης).

Απόκριση · Παράδειγμα

{
  "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
  "operation": "refund",
  "status": "requested",
  "amount": "250.00",
  "currency": "USD",
  "reason": "Customer cancelled the order.",
  "provider_reference": "string",
  "provider_refunded_at": "2026-09-26T09:00:00.000Z",
  "created_at": "2026-09-26T09:00:00.000Z",
  "updated_at": "2026-09-26T09:00:00.000Z",
  "payment_code": "ab34cdef",
  "environment": "live"
}

Πιθανά σφάλματα

Ειδοποίηση

Όταν ολοκληρωθεί μια επιστροφή, στέλνεται υπογεγραμμένη ειδοποίηση payment.refunded στη διεύθυνση webhook της πληρωμής. Οι κεφαλίδες, η υπογραφή και οι επαναλήψεις είναι ίδιες με τα Webhooks. Ένα void δεν στέλνει ειδοποίηση.

POSTpayment.refunded

Υπογεγραμμένη ειδοποίηση payment.refunded προς το URL του εμπόρου

Σώμα αιτήματος

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`event_id`	`string · uuid`	Υποχρεωτικό
`event_type`	`string`	Υποχρεωτικό	`payment.refunded`
`environment`	`string`	Υποχρεωτικό	`sandboxlive`
`occurred_at`	`string · date-time`	Υποχρεωτικό
`refund`	`object`	Υποχρεωτικό
`refund.public_id`	`string · uuid`	Υποχρεωτικό
`refund.status`	`string`	Υποχρεωτικό	`completed`
`refund.amount`	`string`	Υποχρεωτικό	Θετικό ποσό ως δεκαδική συμβολοσειρά σταθερής κλίμακας με 2 δεκαδικά. Το "0.00" δεν γίνεται δεκτό.
`refund.currency_code`	`string`	Υποχρεωτικό	Κωδικός νομίσματος fiat, περιορισμένος στα τέσσερα υποστηριζόμενα νομίσματα. `USDEURAEDTRY`
`refund.completed_at`	`string · date-time`	Υποχρεωτικό	Η ίδια χρονική στιγμή με το `occurred_at`.
`payment`	`object`	Υποχρεωτικό
`payment.public_id`	`string · uuid`	Υποχρεωτικό
`payment.code`	`string`	Υποχρεωτικό	`minLength 1maxLength 16`
`payment.merchant_reference`	`string \| null`	Υποχρεωτικό	`maxLength 64`
`order`	`object`	Υποχρεωτικό
`order.public_id`	`string · uuid`	Υποχρεωτικό

Σώμα αιτήματος · Παράδειγμα

{
  "event_id": "B5D4E456-EFC1-4EC2-A613-D64A16E45BD5",
  "event_type": "payment.refunded",
  "environment": "sandbox",
  "occurred_at": "2026-09-28T12:00:00.000Z",
  "refund": {
    "public_id": "A1B2C3D4-E5F6-4789-8ABC-DEF012345678",
    "status": "completed",
    "amount": "100.00",
    "currency_code": "USD",
    "completed_at": "2026-09-28T12:00:00.000Z"
  },
  "payment": {
    "public_id": "11111111-2222-4333-8444-555555555555",
    "code": "ab34cdef",
    "merchant_reference": "SIP-2026-0001"
  },
  "order": {
    "public_id": "66666666-7777-4888-8999-AAAAAAAAAAAA"
  }
}

Αναλήψεις

Ζητήστε ανάληψη USDT (TRC20) και παρακολουθήστε την.

Στο live, Το HTTP 201 σημαίνει ότι το αίτημα έγινε δεκτό και το ποσό δεσμεύτηκε, όχι ότι στάλθηκαν τα USDT. Ελέγξτε τα status και tx_hash και επαληθεύστε διπλά τη διεύθυνση: μια μεταφορά στο blockchain δεν αναιρείται.

Μια ανάληψη sandbox χρεώνει το εικονικό υπόλοιπο και δεν στέλνει ποτέ τίποτα στο blockchain. Ακολουθεί τους ίδιους κανόνες με το live, συμπεριλαμβανομένων του ελάχιστου ποσού, του ημερήσιου ανώτατου ορίου και της ισοτιμίας μετατροπής. Στείλτε X-CAV-Sandbox-Scenario: rejected για να δοκιμάσετε μια απόρριψη. Το sandbox δέχεται τη μηδενική διεύθυνση TRON ως προορισμό· το live απορρίπτει τις διευθύνσεις καύσης με 1000030.

Το ελάχιστο ποσό και το ημερήσιο ανώτατο όριο ορίζονται ανά λογαριασμό από την Manuell· κάτω από το ελάχιστο το API επιστρέφει 9000019, πάνω από το όριο 9000021. Στο live, ένας χειριστής της Manuell στέλνει τα USDT και καταγράφει το tx_hash (sent) ή απορρίπτει το αίτημα με αιτιολογία (rejected) και το ποσό επιστρέφεται στο υπόλοιπό σας.

POST/api/v3/withdrawalsΑπαιτεί Idempotency-Key

Αίτημα ανάληψης USDT

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`X-CAV-Sandbox-Scenario`	`string · header`	Προαιρετικό	Μόνο για κλειδιά sandbox. Επιλέγει το προσομοιωμένο αποτέλεσμα: `sent` (προεπιλογή) ή `rejected` (χωρίς επίδραση στο εικονικό πορτοφόλι). Ένα live κλειδί που στέλνει αυτή την κεφαλίδα, ή οποιοδήποτε κλειδί που στέλνει άλλη τιμή, λαμβάνει 422 `1000001`. Η κεφαλίδα δεν αποτελεί μέρος της υπογεγραμμένης συμβολοσειράς· αποτελεί όμως μέρος του αποτυπώματος του Idempotency-Key, γι' αυτό η επαναχρησιμοποίηση ενός κλειδιού με άλλο σενάριο επιστρέφει 9000010. Το εφαρμοσμένο σενάριο επιστρέφεται στην κεφαλίδα απόκρισης με το ίδιο όνομα. `sentrejected`

Σώμα αιτήματος

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`amount`	`string`	Υποχρεωτικό	Ποσό προς δέσμευση από το πορτοφόλι API, στο ρυθμισμένο βασικό νόμισμα της πλατφόρμας, ως δεκαδική συμβολοσειρά με 2 δεκαδικά. Το ελάχιστο ποσό και το ημερήσιο ανώτατο όριο ορίζονται ανά λογαριασμό από τον διαχειριστή της πλατφόρμας: ποσό κάτω από το ελάχιστο επιστρέφει 9000019 και ποσό πάνω από το ημερήσιο όριο επιστρέφει 9000021. Ρωτήστε τον υπεύθυνο λογαριασμού σας για τα όριά σας.
`address`	`string`	Υποχρεωτικό	Η δική σας, ελεγμένη διεύθυνση TRON για ανάληψη USDT TRC20. Το παράδειγμα είναι σύμβολο κράτησης θέσης και θα απορριφθεί αν σταλεί αμετάβλητο. `maxLength 64`
`address_acknowledged`	`boolean`	Υποχρεωτικό	Πρέπει να είναι true — επιβεβαιώνετε ότι η διεύθυνση προορισμού είναι σωστή και ότι η μεταφορά δεν αναιρείται.

Σώμα αιτήματος · Παράδειγμα

{
  "amount": "250.00",
  "address": "REPLACE_WITH_YOUR_TRON_ADDRESS",
  "address_acknowledged": true
}

Απόκριση · 201

Η ανάληψη ζητήθηκε. Το υπόλοιπο δεσμεύεται· η αποστολή στο blockchain γίνεται χειροκίνητα. Με κλειδί sandbox επιστρέφεται το προσομοιωμένο αποτέλεσμα (environment sandbox)· μια επανάληψη idempotent επιστρέφει επίσης 201.

`Withdrawal`

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string`	Υποχρεωτικό	Αναγνωριστικό αιτήματος ανάληψης (UUID).
`status`	`string`	Υποχρεωτικό	Κατάσταση κύκλου ζωής της ανάληψης: `requested` → `sent` ή `rejected`. Η αποστολή στο blockchain γίνεται χειροκίνητα από τον διαχειριστή της πλατφόρμας. Με κλειδί sandbox η κατάσταση είναι άμεσα οριστική: `sent` (προεπιλογή) ή `rejected`. `requestedsentrejected`
`amount`	`string`	Υποχρεωτικό	Ποσό που ζητήθηκε και δεσμεύτηκε από το πορτοφόλι API, στο βασικό νόμισμα της πλατφόρμας, ως δεκαδική συμβολοσειρά με 2 δεκαδικά· δεν είναι ποσό USDT.
`currency`	`string`	Υποχρεωτικό	Βασικό νόμισμα στο οποίο εκφράζεται το ποσό.
`asset`	`string`	Υποχρεωτικό	Περιουσιακό στοιχείο ανάληψης (USDT).
`network`	`string`	Υποχρεωτικό	Δίκτυο ανάληψης (TRC20).
`address`	`string`	Υποχρεωτικό	Διεύθυνση προορισμού που δώσατε.
`usdt_amount`	`string`	Υποχρεωτικό	Ποσό USDT που υπολογίζεται όταν γίνεται δεκτό το αίτημα, ως δεκαδική συμβολοσειρά σταθερής κλίμακας με 6 δεκαδικά. Αυτό το πεδίο από μόνο του δεν επιβεβαιώνει μεταφορά στο blockchain.
`tx_hash`	`string \| null`	Υποχρεωτικό	Hash της συναλλαγής στο blockchain, που συμπληρώνεται μετά την αποστολή. Στο sandbox επιστρέφεται συνθετικό hash 64 χαρακτήρων για ανάληψη `sent`· δεν πραγματοποιείται καμία μεταφορά στο blockchain.
`rejection_reason`	`string \| null`	Υποχρεωτικό	Αιτιολογία, που συμπληρώνεται σε περίπτωση απόρριψης. Στο sandbox μια απορριφθείσα ανάληψη φέρει `Sandbox scenario: rejected`.
`requested_at`	`string · date-time`	Υποχρεωτικό	Ώρα του αιτήματος (UTC).
`processed_at`	`string · date-time \| null`	Υποχρεωτικό	Πότε στάλθηκε ή απορρίφθηκε (UTC).
`created_at`	`string · date-time`	Υποχρεωτικό	Ώρα δημιουργίας της εγγραφής (UTC).
`environment`	`string`	Υποχρεωτικό	Περιβάλλον της ανάληψης (το περιβάλλον του κλειδιού υπογραφής). `livesandbox`

Απόκριση · Παράδειγμα

{
  "id": "7F0C2A94-3B1E-4D58-9A6F-1C2D3E4F5A6B",
  "status": "requested",
  "amount": "250.00",
  "currency": "USD",
  "asset": "USDT",
  "network": "TRC20",
  "address": "REPLACE_WITH_YOUR_TRON_ADDRESS",
  "usdt_amount": "249.000000",
  "tx_hash": null,
  "rejection_reason": null,
  "requested_at": "2026-09-26T09:30:00.000Z",
  "processed_at": null,
  "created_at": "2026-09-26T09:30:00.000Z",
  "environment": "live"
}

Πιθανά σφάλματα

GET/api/v3/withdrawals

Λίστα αναλήψεων

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`page`	`integer · query`	Προαιρετικό	Αριθμός σελίδας. `minimum 1`
`per_page`	`integer · query`	Προαιρετικό	Στοιχεία ανά σελίδα. `minimum 1maximum 100`
`status`	`string · query`	Προαιρετικό	Φιλτράρισμα ανά κατάσταση. `requestedsentrejected`

Απόκριση · 200

Σελιδοποιημένες αναλήψεις.

Πεδίο	Τύπος	Περιγραφή
`data`	`Withdrawal[]`
`meta`	`PaginationMeta`

Απόκριση · Παράδειγμα

{
  "data": [
    {
      "id": "7F0C2A94-3B1E-4D58-9A6F-1C2D3E4F5A6B",
      "status": "requested",
      "amount": "250.00",
      "currency": "USD",
      "asset": "USDT",
      "network": "TRC20",
      "address": "REPLACE_WITH_YOUR_TRON_ADDRESS",
      "usdt_amount": "249.000000",
      "tx_hash": null,
      "rejection_reason": null,
      "requested_at": "2026-09-26T09:30:00.000Z",
      "processed_at": null,
      "created_at": "2026-09-26T09:30:00.000Z",
      "environment": "live"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

Πιθανά σφάλματα

GET/api/v3/withdrawals/{id}

Ανάκτηση κατάστασης ανάληψης

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string · uuid · path`	Υποχρεωτικό	Το αναγνωριστικό της ανάληψης.

Απόκριση · 200

Η ανάληψη.

Αντικείμενο: Withdrawal (τα πεδία αναφέρονται στο Αίτημα ανάληψης USDT).

Απόκριση · Παράδειγμα

{
  "id": "7F0C2A94-3B1E-4D58-9A6F-1C2D3E4F5A6B",
  "status": "requested",
  "amount": "250.00",
  "currency": "USD",
  "asset": "USDT",
  "network": "TRC20",
  "address": "REPLACE_WITH_YOUR_TRON_ADDRESS",
  "usdt_amount": "249.000000",
  "tx_hash": null,
  "rejection_reason": null,
  "requested_at": "2026-09-26T09:30:00.000Z",
  "processed_at": null,
  "created_at": "2026-09-26T09:30:00.000Z",
  "environment": "live"
}

Πιθανά σφάλματα

Αμφισβητήσεις

Δείτε τις αμφισβητήσεις και υποβάλετε τα στοιχεία σας.

Οι αμφισβητήσεις προέρχονται από τα δίκτυα καρτών, γι' αυτό στο sandbox δημιουργείτε εσείς μια δοκιμαστική αμφισβήτηση με POST /api/v3/sandbox/disputes. Βλ. Δοκιμή των λειτουργιών λογαριασμού.

Η Manuell καταγράφει μια αμφισβήτηση όταν την ειδοποιήσει η τράπεζα. Το αμφισβητούμενο ποσό αφαιρείται από το υπόλοιπό σας (το υπόλοιπο μπορεί να γίνει αρνητικό και το can_withdraw γίνεται false) και επιστρέφεται αν κερδίσετε. Στείλτε τα στοιχεία σας πριν από το evidence_due_at· ένα νέο Idempotency-Key αντικαθιστά την προηγούμενη σημείωσή σας όσο η αμφισβήτηση είναι ανοιχτή.

GET/api/v3/disputes

Λίστα αμφισβητήσεων

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`page`	`integer · query`	Προαιρετικό	Αριθμός σελίδας. `minimum 1`
`per_page`	`integer · query`	Προαιρετικό	Στοιχεία ανά σελίδα. `minimum 1maximum 100`
`status`	`string · query`	Προαιρετικό	Φιλτράρισμα ανά κατάσταση. `openunder_reviewwonlost`

Απόκριση · 200

Σελιδοποιημένες αμφισβητήσεις.

Πεδίο	Τύπος	Περιγραφή
`data`	`Dispute[]`
`meta`	`PaginationMeta`

`Dispute`

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string`	Υποχρεωτικό	Αναγνωριστικό αμφισβήτησης (UUID).
`service`	`string`	Υποχρεωτικό	Υπηρεσία στην οποία ανήκει η αμφισβητούμενη πληρωμή: `api` για πληρωμή που δημιουργήθηκε μέσω αυτού του API, `link` για σύνδεσμο πληρωμής.
`amount`	`string`	Υποχρεωτικό	Αμφισβητούμενο ποσό (δεκαδική συμβολοσειρά).
`currency`	`string`	Υποχρεωτικό	Νόμισμα της αμφισβήτησης.
`status`	`string`	Υποχρεωτικό	Κατάσταση αμφισβήτησης. `openunder_reviewwonlost`
`reason`	`string`	Υποχρεωτικό	Κατηγορία αιτίας της αμφισβήτησης. `fraudunauthorizedproduct_not_deliveredduplicateamount_mismatchother`
`reason_note`	`string \| null`	Υποχρεωτικό	Σημείωση αιτίας της τράπεζας, αυτούσια.
`occurred_on`	`string · date`	Υποχρεωτικό	Ημερομηνία ανοίγματος της αμφισβήτησης (YYYY-MM-DD).
`evidence_due_at`	`string · date-time \| null`	Υποχρεωτικό	Προθεσμία υποβολής αποδεικτικών στοιχείων (UTC). Μια αμφισβήτηση sandbox παραμένει ανοιχτή για αποδεικτικά στοιχεία επί 7 ημέρες μετά τη δημιουργία της.
`evidence_submitted_at`	`string · date-time \| null`	Υποχρεωτικό	Πότε υπέβαλε η πλατφόρμα την υπεράσπιση στην τράπεζα.
`merchant_evidence_note`	`string \| null`	Υποχρεωτικό	Η σημείωση που υποβάλατε.
`merchant_evidence_submitted_at`	`string · date-time \| null`	Υποχρεωτικό	Πότε υποβάλατε τη σημείωσή σας.
`resolved_at`	`string · date-time \| null`	Υποχρεωτικό	Πότε έκλεισε η αμφισβήτηση.
`created_at`	`string · date-time`	Υποχρεωτικό	Ώρα δημιουργίας της εγγραφής (UTC).
`payment_code`	`string \| null`	Υποχρεωτικό	Κωδικός της πληρωμής API στην οποία ανήκει η αμφισβήτηση (το `code` που επιστράφηκε κατά τη δημιουργία της πληρωμής)· null όταν η αμφισβήτηση δεν συνδέεται με πληρωμή API.
`environment`	`string`	Υποχρεωτικό	Περιβάλλον της αμφισβήτησης (το περιβάλλον του κλειδιού υπογραφής). `livesandbox`

Απόκριση · Παράδειγμα

{
  "data": [
    {
      "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
      "service": "api",
      "amount": "250.00",
      "currency": "USD",
      "status": "open",
      "reason": "fraud",
      "reason_note": "string",
      "occurred_on": "2026-09-26",
      "evidence_due_at": "2026-09-26T09:00:00.000Z",
      "evidence_submitted_at": "2026-09-26T09:00:00.000Z",
      "merchant_evidence_note": "string",
      "merchant_evidence_submitted_at": "2026-09-26T09:00:00.000Z",
      "resolved_at": "2026-09-26T09:00:00.000Z",
      "created_at": "2026-09-26T09:00:00.000Z",
      "payment_code": "ab34cdef",
      "environment": "live"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

Πιθανά σφάλματα

GET/api/v3/disputes/{id}

Ανάκτηση αμφισβήτησης

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string · uuid · path`	Υποχρεωτικό	Το αναγνωριστικό της αμφισβήτησης.

Απόκριση · 200

Η αμφισβήτηση.

Αντικείμενο: Dispute (τα πεδία αναφέρονται στο Λίστα αμφισβητήσεων).

Απόκριση · Παράδειγμα

{
  "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
  "service": "api",
  "amount": "250.00",
  "currency": "USD",
  "status": "open",
  "reason": "fraud",
  "reason_note": "string",
  "occurred_on": "2026-09-26",
  "evidence_due_at": "2026-09-26T09:00:00.000Z",
  "evidence_submitted_at": "2026-09-26T09:00:00.000Z",
  "merchant_evidence_note": "string",
  "merchant_evidence_submitted_at": "2026-09-26T09:00:00.000Z",
  "resolved_at": "2026-09-26T09:00:00.000Z",
  "created_at": "2026-09-26T09:00:00.000Z",
  "payment_code": "ab34cdef",
  "environment": "live"
}

Πιθανά σφάλματα

POST/api/v3/disputes/{id}/evidenceΑπαιτεί Idempotency-Key

Υποβολή αποδεικτικών στοιχείων αμφισβήτησης

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string · uuid · path`	Υποχρεωτικό	Το αναγνωριστικό της αμφισβήτησης.

Σώμα αιτήματος

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`note`	`string`	Υποχρεωτικό	Το κείμενο των αποδεικτικών στοιχείων σας για την αμφισβήτηση. `minLength 3maxLength 4000`

Σώμα αιτήματος · Παράδειγμα

{
  "note": "Order 4821 was delivered on 2026-09-25. Carrier reference ABC123."
}

Απόκριση · 200

Τα αποδεικτικά στοιχεία καταγράφηκαν· η κατάσταση της αμφισβήτησης δεν αλλάζει. Μια πανομοιότυπη επανάληψη idempotent επιστρέφει το αρχικό σώμα απόκρισης.

Αντικείμενο: Dispute (τα πεδία αναφέρονται στο Λίστα αμφισβητήσεων).

Απόκριση · Παράδειγμα

{
  "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
  "service": "api",
  "amount": "250.00",
  "currency": "USD",
  "status": "open",
  "reason": "fraud",
  "reason_note": "string",
  "occurred_on": "2026-09-26",
  "evidence_due_at": "2026-09-26T09:00:00.000Z",
  "evidence_submitted_at": "2026-09-26T09:00:00.000Z",
  "merchant_evidence_note": "string",
  "merchant_evidence_submitted_at": "2026-09-26T09:00:00.000Z",
  "resolved_at": "2026-09-26T09:00:00.000Z",
  "created_at": "2026-09-26T09:00:00.000Z",
  "payment_code": "ab34cdef",
  "environment": "live"
}

Πιθανά σφάλματα

Διαχείριση παραδόσεων

Ελέγξτε τις παραδόσεις webhook και επαναλάβετε τις αποτυχημένες.

Η διεύθυνση που λαμβάνει τις ειδοποιήσεις ορίζεται ανά περιβάλλον στο “API Key & Ενσωμάτωση”. Τα endpoints παρακάτω απαριθμούν τις παραδόσεις και ξαναβάζουν στην ουρά τις αποτυχημένες.

GET/api/v3/webhooks/deliveries

Λίστα παραδόσεων webhook

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`page`	`integer · query`	Προαιρετικό	Αριθμός σελίδας. `minimum 1`
`per_page`	`integer · query`	Προαιρετικό	Στοιχεία ανά σελίδα. `minimum 1maximum 100`
`status`	`string · query`	Προαιρετικό	Φιλτράρισμα ανά κατάσταση. `pendingdeliveredfailed`

Απόκριση · 200

Σελιδοποιημένες παραδόσεις.

Πεδίο	Τύπος	Περιγραφή
`data`	`WebhookDelivery[]`
`meta`	`PaginationMeta`

`WebhookDelivery`

Πεδίο	Τύπος	Περιγραφή
`id`	`string`	Αναγνωριστικό παράδοσης (UUID).
`event`	`string`	Τύπος συμβάντος παράδοσης: `payment.paid`, `payment.refunded` ή `payment.failed`. Η αποτυχία δεν είναι τελική· η πληρωμή παραμένει created και μπορεί να πληρωθεί αργότερα.
`status`	`string`	Κατάσταση παράδοσης. `pendingdeliveredfailed`
`payment_code`	`string \| null`	Κωδικός σχετικής πληρωμής, αν υπάρχει.
`attempt_count`	`integer`	Αριθμός προσπαθειών παράδοσης μέχρι τώρα.
`last_status_code`	`integer \| null`	Κατάσταση HTTP της τελευταίας προσπάθειας.
`last_error`	`string \| null`	Παλαιό ακατέργαστο σφάλμα παράδοσης· χρησιμοποιήστε last_error_code και last_error_message.
`last_error_code`	`string \| null`	Σταθερός αναγνώσιμος από μηχανή κωδικός σφάλματος παράδοσης. `invalid_webhook_targetwebhook_target_private_networkwebhook_environment_invalidwebhook_signing_unavailablewebhook_response_unsuccessfulwebhook_egress_proxy_unreachablewebhook_unreachablewebhook_delivery_failed`
`last_error_message`	`string \| null`	Σύντομο αναγνώσιμο μήνυμα σφάλματος παράδοσης, επιλεγμένο από το Accept-Language.
`next_attempt_at`	`string · date-time \| null`	Πότε προγραμματίζεται η επόμενη επανάληψη (UTC).
`delivered_at`	`string · date-time \| null`	Πότε παραδόθηκε (UTC).
`created_at`	`string · date-time`	Ώρα δημιουργίας της εγγραφής (UTC).

Απόκριση · Παράδειγμα

{
  "data": [
    {
      "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
      "event": "payment.paid",
      "status": "pending",
      "payment_code": null,
      "attempt_count": 1,
      "last_status_code": null,
      "last_error": null,
      "last_error_code": null,
      "last_error_message": null,
      "next_attempt_at": null,
      "delivered_at": null,
      "created_at": "2026-09-26T09:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

Πιθανά σφάλματα

1000001422

GET/api/v3/webhooks/deliveries/{id}

Ανάκτηση παράδοσης webhook

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string · uuid · path`	Υποχρεωτικό	Το αναγνωριστικό της παράδοσης.

Απόκριση · 200

Η παράδοση, με το url και το payload.

`WebhookDeliveryDetail`

Πεδίο	Τύπος	Περιγραφή
`id`	`string`	Αναγνωριστικό παράδοσης (UUID).
`event`	`string`	Τύπος συμβάντος παράδοσης: `payment.paid`, `payment.refunded` ή `payment.failed`. Η αποτυχία δεν είναι τελική· η πληρωμή παραμένει created και μπορεί να πληρωθεί αργότερα.
`status`	`string`	Κατάσταση παράδοσης. `pendingdeliveredfailed`
`payment_code`	`string \| null`	Κωδικός σχετικής πληρωμής, αν υπάρχει.
`attempt_count`	`integer`	Αριθμός προσπαθειών παράδοσης μέχρι τώρα.
`last_status_code`	`integer \| null`	Κατάσταση HTTP της τελευταίας προσπάθειας.
`last_error`	`string \| null`	Παλαιό ακατέργαστο σφάλμα παράδοσης· χρησιμοποιήστε last_error_code και last_error_message.
`last_error_code`	`string \| null`	Σταθερός αναγνώσιμος από μηχανή κωδικός σφάλματος παράδοσης. `invalid_webhook_targetwebhook_target_private_networkwebhook_environment_invalidwebhook_signing_unavailablewebhook_response_unsuccessfulwebhook_egress_proxy_unreachablewebhook_unreachablewebhook_delivery_failed`
`last_error_message`	`string \| null`	Σύντομο αναγνώσιμο μήνυμα σφάλματος παράδοσης, επιλεγμένο από το Accept-Language.
`next_attempt_at`	`string · date-time \| null`	Πότε προγραμματίζεται η επόμενη επανάληψη (UTC).
`delivered_at`	`string · date-time \| null`	Πότε παραδόθηκε (UTC).
`created_at`	`string · date-time`	Ώρα δημιουργίας της εγγραφής (UTC).
`url`	`string`	Το webhook URL σας για αυτή την παράδοση.
`payload`	`object \| null`	Το σώμα JSON που στάλθηκε.

Απόκριση · Παράδειγμα

{
  "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
  "event": "payment.paid",
  "status": "pending",
  "payment_code": null,
  "attempt_count": 1,
  "last_status_code": null,
  "last_error": null,
  "last_error_code": null,
  "last_error_message": null,
  "next_attempt_at": null,
  "delivered_at": null,
  "created_at": "2026-09-26T09:00:00.000Z",
  "url": "string",
  "payload": null
}

Πιθανά σφάλματα

9000024404

POST/api/v3/webhooks/deliveries/{id}/retryΑπαιτεί Idempotency-Key

Επανάληψη αποτυχημένης παράδοσης

Παράμετροι

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`id`	`string · uuid · path`	Υποχρεωτικό	Το αναγνωριστικό της παράδοσης.

Απόκριση · 200

Η αποτυχημένη παράδοση τέθηκε ξανά στην ουρά. Μια πανομοιότυπη επανάληψη idempotent επιστρέφει την αρχική απόκριση της ουράς χωρίς νέα προσπάθεια.

Αντικείμενο: WebhookDeliveryDetail (τα πεδία αναφέρονται στο Ανάκτηση παράδοσης webhook).

Απόκριση · Παράδειγμα

{
  "id": "9B2E6F3A-0C1D-4E5F-8A7B-000000000001",
  "event": "payment.paid",
  "status": "pending",
  "payment_code": null,
  "attempt_count": 1,
  "last_status_code": null,
  "last_error": null,
  "last_error_code": null,
  "last_error_message": null,
  "next_attempt_at": null,
  "delivered_at": null,
  "created_at": "2026-09-26T09:00:00.000Z",
  "url": "string",
  "payload": null
}

Πιθανά σφάλματα

Σφάλματα παράδοσης

Το last_error είναι πεδίο παλαιού τύπου· χρησιμοποιήστε το last_error_code σε νέες ενσωματώσεις.

Πεδίο	Περιγραφή
`invalid_webhook_target`	Ο προορισμός webhook δεν είναι έγκυρος.
`webhook_target_private_network`	Ο προορισμός webhook επιλύεται σε ιδιωτικό δίκτυο.
`webhook_environment_invalid`	Το περιβάλλον webhook δεν είναι έγκυρο.
`webhook_signing_unavailable`	Δεν ήταν δυνατή η υπογραφή του webhook.
`webhook_response_unsuccessful`	Ο προορισμός επέστρεψε απάντηση εκτός 2xx.
`webhook_egress_proxy_unreachable`	Δεν είναι δυνατή η πρόσβαση στον διακομιστή μεσολάβησης εξόδου της παράδοσης.
`webhook_unreachable`	Δεν είναι δυνατή η πρόσβαση στον προορισμό webhook.
`webhook_delivery_failed`	Η παράδοση webhook απέτυχε.

Κατάσταση υπηρεσίας και συντήρηση

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

GET/api/v3/service-statusΔημόσιο

Ανάκτηση κατάστασης υπηρεσίας

Απόκριση · 200

Υπηρεσίες σε συντήρηση (η λίστα μπορεί να είναι κενή).

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`data`	`ServiceStatusItem[]`	Υποχρεωτικό	Υπηρεσίες που βρίσκονται αυτή τη στιγμή σε συντήρηση· μια κενή λίστα σημαίνει ότι καμία δεν βρίσκεται.

`ServiceStatusItem`

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`service`	`string`	Υποχρεωτικό	Κωδικός υπηρεσίας: `api_collection` (πληρωμές που δημιουργούνται μέσω του API και οι σελίδες πληρωμής τους), `withdrawals` (αιτήματα ανάληψης) ή ένα από τα `link_collection`, `storefront`, `usdt_sales` και `balance_load` (άλλες υπηρεσίες της πλατφόρμας). `api_collectionlink_collectionwithdrawalsstorefrontusdt_salesbalance_load`
`until`	`string · date-time \| null`	Υποχρεωτικό	Εκτιμώμενη ώρα επαναφοράς (UTC, ISO-8601) ή null. Είναι μόνο εκτίμηση: η συντήρηση δεν τελειώνει από μόνη της και μόλις περάσει αυτή η ώρα το πεδίο γίνεται null.
`note`	`string \| null`	Υποχρεωτικό	Σύντομο μήνυμα σε απλό κείμενο από τον διαχειριστή της πλατφόρμας ή null. `maxLength 240`

Απόκριση · Παράδειγμα

{
  "data": [
    {
      "service": "api_collection",
      "until": "2026-10-01T12:00:00Z",
      "note": "Planned maintenance."
    }
  ]
}

Άλλες αποκρίσεις

429Υπέρβαση του ορίου αιτημάτων.

Πιθανά σφάλματα

1000005429

Σελιδοποίηση

Τα endpoints λιστών δέχονται page (προεπιλογή 1) και per_page (προεπιλογή 20, μέγιστο 100) και επιστρέφουν data και meta.

`PaginationMeta`

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`page`	`integer`	Υποχρεωτικό	Αριθμός σελίδας (ξεκινά από το 1).
`per_page`	`integer`	Υποχρεωτικό	Στοιχεία ανά σελίδα (1–100).
`total`	`integer`	Υποχρεωτικό	Συνολικός αριθμός εγγραφών που ταιριάζουν.
`total_pages`	`integer`	Υποχρεωτικό	ceil(total / per_page).

Δοκιμή των λειτουργιών λογαριασμού

Το υπόλοιπο, οι επιστροφές, οι αναλήψεις και οι αμφισβητήσεις λειτουργούν στο sandbox με τα ίδια endpoints, σώματα και κωδικούς σφαλμάτων όπως στο live.

Οι πληρωμές sandbox περνούν αμέσως στο available_amount, χωρίς αναμονή ημερομηνίας αξίας.
Τα αιτήματα επιστροφής και ανάληψης ολοκληρώνονται αμέσως. Το αποτέλεσμα επιλέγεται με την κεφαλίδα X-CAV-Sandbox-Scenario.
Οι αμφισβητήσεις προέρχονται από την τράπεζα, γι' αυτό στο sandbox δημιουργείτε μία με POST /api/v3/sandbox/disputes.

Δείτε τις δοκιμές επιστροφών, αναλήψεων και αμφισβητήσεων στο “Λειτουργίες Sandbox”.

Επιλογή αποτελέσματος

Τα αιτήματα επιστροφής και ανάληψης χρησιμοποιούν τα ίδια endpoints και σώματα με το live. Για να επιλέξετε το αποτέλεσμα, προσθέστε την προαιρετική κεφαλίδα X-CAV-Sandbox-Scenario. Δεν αποτελεί μέρος της υπογραφής. Με live κλειδί η κεφαλίδα απορρίπτεται με 422 (1000001), ώστε μια δοκιμή να μην μπορεί ποτέ να γίνει πραγματικό αίτημα.

X-CAV-Sandbox-Scenario

X-CAV-Sandbox-Scenario: rejected

Endpoint	Τιμές κεφαλίδας	Προεπιλογή	Επίδραση
`POST /api/v3/refunds`	`completed` `rejected`	`completed`	Το `completed` οριστικοποιεί την επιστροφή και χρεώνει το εικονικό υπόλοιπο· το `rejected` καταγράφει την απόρριψη και δεν αλλάζει τίποτα.
`POST /api/v3/withdrawals`	`sent` `rejected`	`sent`	Το `sent` χρεώνει το εικονικό υπόλοιπο και συμπληρώνει το `tx_hash` με μια προσωρινή τιμή· το `rejected` αποδεσμεύει το ποσό.
`POST /api/v3/sandbox/disputes`	`open` `won` `lost`	`open`	Ορίζεται στο σώμα του αιτήματος και όχι σε κεφαλίδα. `open`, `won` ή `lost`.

Δοκιμαστική αμφισβήτηση

Οι αμφισβητήσεις προέρχονται από τα δίκτυα καρτών και δεν μπορούν να ξεκινήσουν από την πλευρά σας στο live. Αυτό είναι το μοναδικό endpoint μόνο για sandbox: δημιουργεί μια δοκιμαστική αμφισβήτηση για μια εξοφλημένη πληρωμή sandbox και επιστρέφει το ίδιο αντικείμενο Dispute με το live.

POST/api/v3/sandbox/disputesΑπαιτεί Idempotency-Key

Δημιουργία αμφισβήτησης sandbox για μια εξοφλημένη πληρωμή sandbox

Σώμα αιτήματος

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
`payment_code`	`string`	Υποχρεωτικό	Αντικαταστήστε το με τον κωδικό μιας εξοφλημένης πληρωμής που δημιουργήσατε με το δικό σας κλειδί sandbox. `maxLength 16`
`scenario`	`string`	Προαιρετικό	Αποτέλεσμα προς καταγραφή: το `open` (προεπιλογή) παραμένει ανοιχτό για αποδεικτικά στοιχεία· τα `won` και `lost` έχουν ήδη επιλυθεί. `openwonlost`
`reason`	`string`	Υποχρεωτικό	Κατηγορία αιτίας αμφισβήτησης· οι ίδιες τιμές με το `Dispute.reason`. `fraudunauthorizedproduct_not_deliveredduplicateamount_mismatchother`

Σώμα αιτήματος · Παράδειγμα

{
  "payment_code": "ab34cdef",
  "scenario": "open",
  "reason": "fraud"
}

Απόκριση · 201

Η αμφισβήτηση καταγράφηκε· μια επανάληψη idempotent επιστρέφει την ίδια αμφισβήτηση.

Αντικείμενο: Dispute (τα πεδία αναφέρονται στο Λίστα αμφισβητήσεων).

Απόκριση · Παράδειγμα

{
  "id": "B5D4E456-EFC1-4EC2-A613-D64A16E45BD5",
  "service": "api",
  "amount": "250.00",
  "currency": "USD",
  "status": "open",
  "reason": "fraud",
  "reason_note": null,
  "occurred_on": "2026-09-30",
  "evidence_due_at": "2026-10-07T09:00:00.000Z",
  "evidence_submitted_at": null,
  "merchant_evidence_note": null,
  "merchant_evidence_submitted_at": null,
  "resolved_at": null,
  "created_at": "2026-09-30T09:00:00.000Z",
  "payment_code": "ab34cdef",
  "environment": "sandbox"
}