Kontovorgänge

Diese Endpoints umfassen Guthaben, Rückerstattungen, Auszahlungen und Antworten auf Anfechtungen. Sie verwenden dieselben Schlüssel und Hilfsfunktionen für Anfragen wie die Zahlungs-Endpoints.

Endpoint	Zweck
`GET /api/account/balance`	Guthaben
`GET /api/account/available-balance`	Auszahlbares Guthaben
`POST /api/account/refunds`	Zahlung zurückerstatten oder stornieren
`GET /api/account/refunds[/{id}]`	Rückerstattungen auflisten oder abrufen
`POST /api/account/withdrawals`	USDT-Auszahlung anfordern
`GET /api/account/withdrawals[/{id}]`	Auszahlungen auflisten oder abrufen
`GET /api/account/disputes[/{id}]`	Anfechtungen auflisten oder abrufen
`POST /api/account/disputes/{id}/evidence`	Auf eine Anfechtung antworten

Konventionen

Signierung, Header und Idempotency-Key funktionieren wie unter Authentifizierung beschrieben.
Ein einzelner Eintrag wird als einfaches JSON-Objekt zurückgegeben; Listen werden als { "data": [...], "meta": {...} } zurückgegeben.
Zahlungs-, Erstattungs-, Auszahlungs- und Streitfall-IDs haben das Format LUVEI-ABCD-123456. Speichern Sie die vollständige ID.
Guthaben und Auszahlungen verwenden die Hauptwährung des Systems; Rückerstattungen und Anfechtungen verwenden die Währung der Zahlung.
201 oder 202 bedeutet, dass die Anfrage angenommen, nicht dass sie abgeschlossen wurde. Verfolgen Sie den Status oder die Webhooks.
Wie Sie Ergebnisse mit einem Sandbox-Schlüssel testen, erfahren Sie unter Sandbox und Testkarten.

Paginierung

Feld	Typ	Erforderlich	Beschreibung
`page`	`integer · query`	Optional	Seitennummer, beginnend bei `1`.
`per_page`	`integer · query`	Optional	Einträge pro Seite, von `1` bis `100`. Standard: `20`.
`status`	`string · query`	Optional	Liefert nur Einträge mit diesem Status.

Feld	Typ	Beschreibung
`page`	`integer`	Aktuelle Seite.
`per_page`	`integer`	Einträge pro Seite.
`total`	`integer`	Anzahl der passenden Einträge.
`total_pages`	`integer`	Anzahl der Seiten (`0`, wenn die Liste leer ist).

Die neuesten Einträge werden zuerst aufgeführt. Eine Seite nach der letzten liefert 200 mit leerem data. Ein page kleiner als 1, ein per_page außerhalb von 1–100, ein unbekannter status oder ein unbekannter Parameter führt zu 422 1000001. Datumsfilter werden nicht unterstützt.

Listenantwort · Beispiel

{
  "data": [
    {
      "id": "LUVEI-RFND-100001",
      "operation": "refund",
      "status": "requested",
      "amount": "100.00",
      "currency": "USD",
      "reason": "Customer requested a full refund",
      "provider_reference": null,
      "provider_refunded_at": null,
      "created_at": "2026-11-02T09:00:00.000Z",
      "updated_at": null,
      "payment_id": "LUVEI-PAYN-123456",
      "environment": "live"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

GET/api/account/balance

Guthaben

Rufen Sie Ihr Guthaben und den derzeit für Auszahlungen verfügbaren Betrag ab. Beide Aufrufe sind rein lesend und beziehen sich auf Ihre API-Wallet, in der die über diese API eingezogenen Gelder geführt werden. Andere Wallets in Ihrem Panel werden weder angezeigt noch einbezogen.

Feld	Typ	Beschreibung
`currency_code`	`string`	Währung aller Beträge: die Hauptwährung des Systems.
`available_amount`	`string`	Abgerechnete Gelder in Ihrer API-Wallet, die sofort verwendet werden können. Nicht abgerechnete und einbehaltene Beträge sind nicht enthalten.
`pending_settlement_amount`	`string`	Gelder aus Zahlungen, die noch nicht abgerechnet sind. In der Sandbox immer `0.00`.
`environment`	`string`	`sandbox` oder `live`.

cURLNode.jsPHPPython

./payniko.sh GET '/api/account/balance'

import {api} from './payniko.mjs';

const balance = await api('GET', '/api/account/balance');
console.log(balance);

<?php
require __DIR__ . '/payniko.php';

$balance = payniko_api('GET', '/api/account/balance');
print_r($balance);

from payniko import api

balance = api("GET", "/api/account/balance")
print(balance)

Antwort · Beispiel

{
  "currency_code": "USD",
  "available_amount": "1250.00",
  "pending_settlement_amount": "300.00",
  "environment": "live"
}

Zahlungen in anderen Währungen werden in die Hauptwährung umgerechnet. Gebühren und Abrechnungstermine sind in dieser Antwort nicht enthalten.

GET/api/account/available-balance

Auszahlbares Guthaben

Feld	Typ	Beschreibung
`currency_code`	`string`	Die Hauptwährung des Systems.
`withdrawable_amount`	`string`	Abgerechnete Gelder in Ihrer API-Wallet, die sofort ausgezahlt werden können. Dies ist genau der Betrag, den Sie mit `POST /api/account/withdrawals` auszahlen können.
`can_withdraw`	`boolean`	`false`, solange eines Ihrer Guthaben negativ ist; in diesem Fall ist keine Auszahlung möglich. `true` garantiert keine Auszahlung.
`environment`	`string`	`sandbox` oder `live`.

cURLNode.jsPHPPython

./payniko.sh GET '/api/account/available-balance'

import {api} from './payniko.mjs';

const available = await api('GET', '/api/account/available-balance');
console.log(available);

<?php
require __DIR__ . '/payniko.php';

$available = payniko_api('GET', '/api/account/available-balance');
print_r($available);

from payniko import api

available = api("GET", "/api/account/available-balance")
print(available)

Antwort · Beispiel

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

Für offene Auszahlungen reservierte Beträge, nicht abgerechnete Gelder und Einbehalte sind nicht enthalten. Das Guthaben wird bei der Anforderung einer Auszahlung erneut geprüft; die Anfrage kann daher dennoch mit 409 9000020 fehlschlagen.

POST/api/account/refundsIdempotency-Key erforderlich

Rückerstattung oder Stornierung anfordern

Erstatten Sie dem Zahler den vollen Betrag einer erfolgreichen Zahlung zurück. Jede Anfrage wird von Payniko geprüft und bearbeitet; 202 bestätigt lediglich, dass die Anfrage angenommen wurde.

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung	Beispiel
`payment_id`	`string · LUVEI-ABCD-123456`	Erforderlich	Eine Zahlung mit dem Status `succeeded`, die über `/api/payments` in derselben Umgebung erstellt wurde. Jede andere ID liefert `404` `9000009`.	`LUVEI-PAYN-123456`
`operation_type`	`string`	Erforderlich	Der angeforderte Vorgang. `refundvoid`	`refund`
`reason`	`string`	Erforderlich	3–500 Zeichen. Wird vom Betriebsteam von Payniko geprüft.	`Customer requested a full refund`

Es gibt kein Betragsfeld; es wird der volle Zahlungsbetrag zurückerstattet. Eine Zahlung kann jeweils nur eine Rückerstattung oder Stornierung haben. Solange eine solche offen oder abgeschlossen ist oder für die Zahlung eine nicht gewonnene Anfechtung besteht, liefert eine neue Anfrage 409 9000014.

cURLNode.jsPHPPython

KEY="$(openssl rand -hex 16)"  # store with the order before sending; reuse it after network errors
./payniko.sh POST '/api/account/refunds' '{
  "payment_id": "LUVEI-PAYN-123456",
  "operation_type": "refund",
  "reason": "Customer requested a full refund"
}' "$KEY"

import {api, randomUUID} from './payniko.mjs';

const key = randomUUID(); // Store this key with the order before sending; reuse it after network errors.
const refund = await api('POST', '/api/account/refunds', {
  "payment_id": "LUVEI-PAYN-123456",
  "operation_type": "refund",
  "reason": "Customer requested a full refund"
}, key);
console.log(refund);

<?php
require __DIR__ . '/payniko.php';

$key = bin2hex(random_bytes(16)); // store with the order; reuse it after network errors
$refund = payniko_api('POST', '/api/account/refunds', [
    "payment_id" => 'LUVEI-PAYN-123456',
    "operation_type" => 'refund',
    "reason" => 'Customer requested a full refund',
], $key);
print_r($refund);

from payniko import api
import uuid

key = str(uuid.uuid4())  # store with the order; reuse it after network errors
refund = api("POST", "/api/account/refunds", {
    "payment_id": "LUVEI-PAYN-123456",
    "operation_type": "refund",
    "reason": "Customer requested a full refund"
}, key)
print(refund)

Antwort · Beispiel

{
  "id": "LUVEI-RFND-100001",
  "operation": "refund",
  "status": "requested",
  "amount": "100.00",
  "currency": "USD",
  "reason": "Customer requested a full refund",
  "provider_reference": null,
  "provider_refunded_at": null,
  "created_at": "2026-11-02T09:00:00.000Z",
  "updated_at": null,
  "payment_id": "LUVEI-PAYN-123456",
  "environment": "live"
}

Antwort · 202

Liefert die Rückerstattung. Werden derselbe Idempotenzschlüssel und derselbe Body erneut gesendet, lautet die Antwort 202 mit derselben Rückerstattung.

Mögliche Fehler

Rückerstattungen auflisten und abrufen

cURLNode.jsPHPPython

./payniko.sh GET '/api/account/refunds?status=completed&page=1&per_page=20'

import {api} from './payniko.mjs';

const refunds = await api('GET', '/api/account/refunds?status=completed&page=1&per_page=20');
console.log(refunds);

<?php
require __DIR__ . '/payniko.php';

$refunds = payniko_api('GET', '/api/account/refunds?status=completed&page=1&per_page=20');
print_r($refunds);

from payniko import api

refunds = api("GET", "/api/account/refunds?status=completed&page=1&per_page=20")
print(refunds)

Feld	Typ	Erforderlich	Beschreibung
`page`	`integer · query`	Optional	Seitennummer, beginnend bei `1`.
`per_page`	`integer · query`	Optional	Einträge pro Seite, von `1` bis `100`. Standard: `20`.
`status`	`string · query`	Optional	Liefert nur Rückerstattungen mit diesem Status.
`operation_type`	`string · query`	Optional	`refund` oder `void`.

GET /api/account/refunds/{id} liefert eine einzelne Rückerstattung (404 9000009, wenn sie nicht existiert). Die Liste enthält die über die API angeforderten Rückerstattungen.

Rückerstattungsobjekt

Feld	Typ	Beschreibung
`id`	`string · LUVEI-ABCD-123456`	Rückerstattungs-ID.
`operation`	`string`	`refund` oder `void`, wie in `operation_type` gesendet.
`status`	`string`	Siehe Tabelle unten.
`amount`	`string`	Voller Betrag der Zahlung.
`currency`	`string`	Währung der Zahlung.
`reason`	`string`	Der in der Anfrage angegebene Grund.
`provider_reference`	`string \| null`	Referenz der durchgeführten Rückerstattung, sobald verfügbar.
`provider_refunded_at`	`string · date-time \| null`	Zeitpunkt, zu dem die Rückerstattung durchgeführt wurde, sofern bekannt.
`created_at`	`string · date-time`	Zeitpunkt der Anfrage.
`updated_at`	`string · date-time \| null`	Zeitpunkt der letzten Änderung.
`payment_id`	`string · LUVEI-ABCD-123456 \| null`	Die zurückerstattete Zahlung.
`environment`	`string`	`sandbox` oder `live`.

Status	Bedeutung
`requested`	Angenommen, aber noch nicht bearbeitet.
`processing`	Wird bearbeitet.
`awaiting_provider_manual`	Wird manuell abgeschlossen; dies kann länger dauern.
`completed`	Abgeschlossen. Endstatus.
`rejected`	Abgelehnt. Endstatus.
`failed`	Fehlgeschlagen. Endstatus.
`cancelled`	Abgebrochen. Endstatus.

GET /api/account/refunds/{id} liefert stets den aktuellen Status. Das Ergebnis wird außerdem als Webhook zugestellt.

POST/api/account/withdrawalsIdempotency-Key erforderlich

Auszahlung anfordern

Zahlen Sie Gelder aus Ihrer API-Wallet als USDT im TRON-Netzwerk (TRC20) aus. Der Betrag wird reserviert und nach einer Prüfung gesendet.

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung	Beispiel
`amount`	`string`	Erforderlich	Zwei Nachkommastellen, zum Beispiel `50.00`; darf nicht `0.00` sein und muss mindestens Ihrem Mindestbetrag entsprechen. Zusammen mit den heute angeforderten und gesendeten Auszahlungen muss der Betrag innerhalb Ihres Tageslimits liegen.	`"50.00"`
`address`	`string`	Erforderlich	TRC20-Adresse: 34 Zeichen, beginnend mit `T`, mit gültiger Prüfsumme.	`YOUR_VERIFIED_TRC20_ADDRESS`
`address_acknowledged`	`boolean`	Erforderlich	Muss `true` sein und bestätigt, dass die Adresse korrekt ist.	`true`
`webhook_url`	`string · uri`	Erforderlich	Endpoint, an den die Webhooks zu dieser Auszahlung gesendet werden. Es gelten dieselben Regeln wie für Zahlungen.	`https://merchant.example/webhooks/withdrawals`

success_url und fail_url sind in dieser Anfrage nicht zulässig.

cURLNode.jsPHPPython

# Replace YOUR_VERIFIED_TRC20_ADDRESS with the address you confirmed with its owner.
KEY="$(openssl rand -hex 16)"  # store with the order before sending; reuse it after network errors
./payniko.sh POST '/api/account/withdrawals' '{
  "amount": "50.00",
  "address": "YOUR_VERIFIED_TRC20_ADDRESS",
  "address_acknowledged": true,
  "webhook_url": "https://merchant.example/webhooks/withdrawals"
}' "$KEY"

import {api, randomUUID} from './payniko.mjs';

// Replace YOUR_VERIFIED_TRC20_ADDRESS with the address you confirmed with its owner.
const key = randomUUID(); // Store this key with the order before sending; reuse it after network errors.
const withdrawal = await api('POST', '/api/account/withdrawals', {
  "amount": "50.00",
  "address": "YOUR_VERIFIED_TRC20_ADDRESS",
  "address_acknowledged": true,
  "webhook_url": "https://merchant.example/webhooks/withdrawals"
}, key);
console.log(withdrawal);

<?php
require __DIR__ . '/payniko.php';

// Replace YOUR_VERIFIED_TRC20_ADDRESS with the address you confirmed with its owner.
$key = bin2hex(random_bytes(16)); // store with the order; reuse it after network errors
$withdrawal = payniko_api('POST', '/api/account/withdrawals', [
    "amount" => '50.00',
    "address" => 'YOUR_VERIFIED_TRC20_ADDRESS',
    "address_acknowledged" => true,
    "webhook_url" => 'https://merchant.example/webhooks/withdrawals',
], $key);
print_r($withdrawal);

from payniko import api
import uuid

# Replace YOUR_VERIFIED_TRC20_ADDRESS with the address you confirmed with its owner.
key = str(uuid.uuid4())  # store with the order; reuse it after network errors
withdrawal = api("POST", "/api/account/withdrawals", {
    "amount": "50.00",
    "address": "YOUR_VERIFIED_TRC20_ADDRESS",
    "address_acknowledged": True,
    "webhook_url": "https://merchant.example/webhooks/withdrawals"
}, key)
print(withdrawal)

Antwort · Beispiel

{
  "id": "LUVEI-WTHD-100002",
  "status": "requested",
  "amount": "50.00",
  "currency": "USD",
  "asset": "USDT",
  "network": "TRC20",
  "address": "YOUR_VERIFIED_TRC20_ADDRESS",
  "usdt_amount": "49.950000",
  "tx_hash": null,
  "rejection_reason": null,
  "requested_at": "2026-11-02T10:00:00.000Z",
  "processed_at": null,
  "created_at": "2026-11-02T10:00:00.000Z",
  "environment": "live"
}

Antwort · 201

Liefert die Auszahlung mit ihrem Status, in der Regel requested. Werden derselbe Idempotenzschlüssel und derselbe Body erneut gesendet, lautet die Antwort 201 mit derselben Auszahlung.

Mögliche Fehler

Auszahlungen auflisten und abrufen

cURLNode.jsPHPPython

./payniko.sh GET '/api/account/withdrawals?status=requested&page=1&per_page=20'

import {api} from './payniko.mjs';

const withdrawals = await api('GET', '/api/account/withdrawals?status=requested&page=1&per_page=20');
console.log(withdrawals);

<?php
require __DIR__ . '/payniko.php';

$withdrawals = payniko_api('GET', '/api/account/withdrawals?status=requested&page=1&per_page=20');
print_r($withdrawals);

from payniko import api

withdrawals = api("GET", "/api/account/withdrawals?status=requested&page=1&per_page=20")
print(withdrawals)

Filtern Sie nach status. GET /api/account/withdrawals/{id} liefert eine einzelne Auszahlung (404 9000023, wenn sie nicht existiert).

Auszahlungsobjekt

Feld	Typ	Beschreibung
`id`	`string · LUVEI-ABCD-123456`	Auszahlungs-ID.
`status`	`string`	Siehe Tabelle unten. `requestedsentrejected`
`amount`	`string`	Angeforderter Betrag in der Hauptwährung.
`currency`	`string`	Die Hauptwährung.
`asset`	`string`	Immer `USDT`.
`network`	`string`	Immer `TRC20`.
`address`	`string`	Zieladresse.
`usdt_amount`	`string`	Zu sendender USDT-Betrag (sechs Nachkommastellen).
`tx_hash`	`string \| null`	Hashwert der Blockchain-Transaktion, sobald bekannt.
`rejection_reason`	`string \| null`	Grund für die Ablehnung.
`requested_at`	`string · date-time`	Zeitpunkt der Anfrage.
`processed_at`	`string · date-time \| null`	Zeitpunkt, zu dem die Auszahlung gesendet oder abgelehnt wurde.
`created_at`	`string · date-time`	Zeitpunkt der Erstellung.
`environment`	`string`	`sandbox` oder `live`.

Status	Bedeutung
`requested`	Erstellt; der Betrag ist reserviert, aber noch nicht gesendet.
`sent`	Gesendet. Endstatus. `tx_hash` kann zunächst `null` sein und wird später ergänzt.
`rejected`	Nicht gesendet; der reservierte Betrag wird Ihrem verfügbaren Guthaben wieder gutgeschrieben. Siehe `rejection_reason`. Endstatus.

Das Payniko-Team sendet jede Auszahlung oder lehnt sie ab und setzt anschließend processed_at sowie tx_hash oder rejection_reason. Während Wartungsarbeiten kann eine neue Auszahlungsanfrage 503 1000014 liefern.

GET/api/account/disputes

Anfechtungen auflisten und abrufen

Eine Anfechtung (Rückbuchung) wird eröffnet, wenn ein Karteninhaber eine Zahlung bei seiner Bank beanstandet. Bei Eröffnung der Anfechtung wird der Betrag in der Regel von Ihrem Guthaben abgezogen; er wird Ihnen wieder gutgeschrieben, wenn Sie die Anfechtung gewinnen, und bleibt abgezogen, wenn Sie sie verlieren. Antworten Sie vor Ablauf der Frist.

cURLNode.jsPHPPython

./payniko.sh GET '/api/account/disputes?status=open&page=1&per_page=20'

import {api} from './payniko.mjs';

const disputes = await api('GET', '/api/account/disputes?status=open&page=1&per_page=20');
console.log(disputes);

<?php
require __DIR__ . '/payniko.php';

$disputes = payniko_api('GET', '/api/account/disputes?status=open&page=1&per_page=20');
print_r($disputes);

from payniko import api

disputes = api("GET", "/api/account/disputes?status=open&page=1&per_page=20")
print(disputes)

Antwort · Beispiel

{
  "data": [
    {
      "id": "LUVEI-DSPT-100003",
      "service": "api",
      "amount": "100.00",
      "currency": "USD",
      "status": "open",
      "reason": "product_not_delivered",
      "reason_note": null,
      "occurred_on": "2026-11-03",
      "evidence_due_at": "2026-11-10T09:00:00.000Z",
      "evidence_submitted_at": null,
      "merchant_evidence_note": null,
      "merchant_evidence_submitted_at": null,
      "resolved_at": null,
      "created_at": "2026-11-03T09:00:00.000Z",
      "payment_id": "LUVEI-PAYN-123456",
      "environment": "sandbox"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

Filtern Sie nach status. GET /api/account/disputes/{id} liefert eine einzelne Anfechtung (404 9000015, wenn sie nicht existiert). Die Liste enthält alle Anfechtungen zu Ihrem Konto; payment_id ist gesetzt, wenn sich die Anfechtung auf eine API-Zahlung bezieht.

Anfechtungsobjekt

Feld	Typ	Beschreibung
`id`	`string · LUVEI-ABCD-123456`	Anfechtungs-ID.
`service`	`string`	Herkunft der Zahlung, zum Beispiel `api`.
`amount`	`string`	Angefochtener Betrag in der Währung der Zahlung.
`currency`	`string`	Währung der Zahlung.
`status`	`string`	Siehe Tabelle unten. `openunder_reviewwonlost`
`reason`	`string`	Von der Bank angegebener Grund. Berücksichtigen Sie auch unbekannte Werte. `fraudunauthorizedproduct_not_deliveredduplicateamount_mismatchother`
`reason_note`	`string \| null`	Anmerkung der Bank, sofern vorhanden.
`occurred_on`	`string · date`	Datum der Anfechtung (`YYYY-MM-DD`).
`evidence_due_at`	`string · date-time \| null`	Frist für Ihre Antwort.
`evidence_submitted_at`	`string · date-time \| null`	Zeitpunkt, zu dem die Stellungnahme bei der Bank eingereicht wurde.
`merchant_evidence_note`	`string \| null`	Ihre letzte Antwort.
`merchant_evidence_submitted_at`	`string · date-time \| null`	Zeitpunkt, zu dem Sie Ihre Antwort übermittelt haben.
`resolved_at`	`string · date-time \| null`	Zeitpunkt, zu dem über die Anfechtung entschieden wurde.
`created_at`	`string · date-time`	Zeitpunkt der Erstellung.
`payment_id`	`string · LUVEI-ABCD-123456 \| null`	Die angefochtene API-Zahlung; andernfalls `null`.
`environment`	`string`	`sandbox` oder `live`.

Status	Bedeutung
`open`	Neue Anfechtung. Sie können bis `evidence_due_at` antworten.
`under_review`	Die Stellungnahme wurde bei der Bank eingereicht, und eine Entscheidung steht aus. Sie können bis zum Ablauf der Frist weiterhin antworten.
`won`	Zu Ihren Gunsten entschieden. Endstatus.
`lost`	Zu Ihren Ungunsten entschieden. Endstatus.

POST/api/account/disputes/{id}/evidenceIdempotency-Key erforderlich

Auf eine Anfechtung antworten

Anfrage-Body

Feld	Typ	Erforderlich	Beschreibung
`note`	`string`	Erforderlich	Ihre Antwort, 3–4000 Zeichen: Lieferdetails, Kommunikation mit dem Kunden und die Ihnen vorliegenden Nachweise.

cURLNode.jsPHPPython

KEY="$(openssl rand -hex 16)"  # store with the order before sending; reuse it after network errors
./payniko.sh POST '/api/account/disputes/LUVEI-DSPT-100003/evidence' '{
  "note": "The order was delivered on 2026-10-28; tracking number and signed receipt are available."
}' "$KEY"

import {api, randomUUID} from './payniko.mjs';

const key = randomUUID(); // Store this key with the order before sending; reuse it after network errors.
const dispute = await api('POST', '/api/account/disputes/LUVEI-DSPT-100003/evidence', {
  "note": "The order was delivered on 2026-10-28; tracking number and signed receipt are available."
}, key);
console.log(dispute);

<?php
require __DIR__ . '/payniko.php';

$key = bin2hex(random_bytes(16)); // store with the order; reuse it after network errors
$dispute = payniko_api('POST', '/api/account/disputes/LUVEI-DSPT-100003/evidence', [
    "note" => 'The order was delivered on 2026-10-28; tracking number and signed receipt are available.',
], $key);
print_r($dispute);

from payniko import api
import uuid

key = str(uuid.uuid4())  # store with the order; reuse it after network errors
dispute = api("POST", "/api/account/disputes/LUVEI-DSPT-100003/evidence", {
    "note": "The order was delivered on 2026-10-28; tracking number and signed receipt are available."
}, key)
print(dispute)

Antwort · Beispiel

{
  "id": "LUVEI-DSPT-100003",
  "service": "api",
  "amount": "100.00",
  "currency": "USD",
  "status": "open",
  "reason": "product_not_delivered",
  "reason_note": null,
  "occurred_on": "2026-11-03",
  "evidence_due_at": "2026-11-10T09:00:00.000Z",
  "evidence_submitted_at": null,
  "merchant_evidence_note": "The order was delivered on 2026-10-28; tracking number and signed receipt are available.",
  "merchant_evidence_submitted_at": "2026-11-04T08:00:00.000Z",
  "resolved_at": null,
  "created_at": "2026-11-03T09:00:00.000Z",
  "payment_id": "LUVEI-PAYN-123456",
  "environment": "sandbox"
}

Antwort · 200

Liefert die Anfechtung einschließlich Ihrer Notiz.

Nur zulässig, solange die Anfechtung den Status open oder under_review hat und evidence_due_at noch nicht erreicht ist; andernfalls liefert die Anfrage 409 9000016.
Eine neue Anfrage mit einem neuen Idempotency-Key ersetzt Ihre vorherige Notiz.
Datei-Uploads werden über die API nicht unterstützt. Beschreiben Sie die vorliegenden Nachweise in der Notiz.

Mögliche Fehler

Um Anfechtungen mit einem Sandbox-Schlüssel zu testen, erstellen Sie eine Anfechtung mit POST /api/sandbox/disputes.