Zahlungsauftrag abrufen

GET 
/api/orders

Gibt Informationen zu einem SCI-Zahlungsauftrag anhand der Bestell-ID des Händlers und optional des SCI-Namens zurück.

Anfrage

Query-Parameter

orderId stringerforderlich
Mögliche Werte: <= 64 Zeichen
Bestellkennung des Händlers.
Beispiel: test-order-001
sciName string
Name der SCI-Integration, optional.
Beispiel: sandbox-sci

Antworten

200

OK

application/json

Schema

Schema

orderIdstring
Bestell-ID.
Beispiel: ORDER_123456
sciNamestring
SCI-Name.
Beispiel: test-value
paymentStatusstring
Zahlungsstatus.
Mögliche Werte: [PENDING, COMPLETED, CANCELED, REFUNDED]
Beispiel: COMPLETED
paymentMethodstring
Zahlungsmethode.
Mögliche Werte: [INTERNAL_OTHERS, CRYPTO_INVOICE]
Beispiel: CRYPTO_INVOICE
paymentCreateddate-time

Erstellungszeitpunkt der Zahlung.

transaction object
Schema Payment Order Transaction Dto.
iduuid
ID.
Beispiel: 11111111-1111-4111-8111-111111111111
statusstring
Status.
Mögliche Werte: [PENDING, COMPLETED, CANCELED, REFUNDED]
Beispiel: COMPLETED
senderAmountnumber
Betrag des Absenders.
Beispiel: 10.25
senderCurrencystring
Währung des Absenders.
Mögliche Werte: [USD, EUR, GBP, RUB, UAH, KZT, BRL, TRY, AZN, ARS, AUD, BDT, CAD, CLP, COP, DOP, EGP, HKD, INR, IDR, JPY, MYR, MXN, MAD, NPR, NZD, PKR, PEN, PHP, SGD, ZAR, KRW, LKR, THB, AED, VND, CNY, CNH, BTC, BNB, BNB_BEP20, BNB_BEP2, BNB_ERC20, BCH, DAI, DOGE, DOGE_DOGENT, DOGE_BEP2, DOGE_BEP20, ETH, LTC, USDP, XRP, SHIB, SHIB_BEP20, SHIB_ERC20, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, TUSD, USDC, USDC_ERC20, USDC_BEP20, USDC_BEP2, ZEC, BUSD, BUSD_BEP20, BUSD_ERC20, BUSD_TRC20, TON, SOL, ADA, AVAX, DOT, LINK, NEAR, POL, DASH, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]
Beispiel: USD
receiverAmountnumber
Betrag des Empfängers.
Beispiel: 10.25
receiverCurrencystring
Währung des Empfängers.
Mögliche Werte: [USD, EUR, GBP, RUB, UAH, KZT, BRL, TRY, AZN, ARS, AUD, BDT, CAD, CLP, COP, DOP, EGP, HKD, INR, IDR, JPY, MYR, MXN, MAD, NPR, NZD, PKR, PEN, PHP, SGD, ZAR, KRW, LKR, THB, AED, VND, CNY, CNH, BTC, BNB, BNB_BEP20, BNB_BEP2, BNB_ERC20, BCH, DAI, DOGE, DOGE_DOGENT, DOGE_BEP2, DOGE_BEP20, ETH, LTC, USDP, XRP, SHIB, SHIB_BEP20, SHIB_ERC20, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, TUSD, USDC, USDC_ERC20, USDC_BEP20, USDC_BEP2, ZEC, BUSD, BUSD_BEP20, BUSD_ERC20, BUSD_TRC20, TON, SOL, ADA, AVAX, DOT, LINK, NEAR, POL, DASH, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]
Beispiel: USD
createddate-time
Erstellungszeitpunkt.
completeddate-time
Abschlusszeitpunkt.
canceleddate-time
Stornierungszeitpunkt.
notestring
Notiz.
Beispiel: Sandbox transfer note
srcWalletIdstring
ID des Quell-Wallets.
Beispiel: USD880390848110
buyerEmailstring
E-Mail des Käufers.
Beispiel: [email protected]
invoice object
Schema Payment Order Invoice Dto.
createddate-time
Erstellungszeitpunkt.
receiveddate-time
Eingangszeitpunkt.
completeddate-time
Abschlusszeitpunkt.
refundRequesteddate-time
Zeitpunkt der Rückerstattungsanfrage.
refundeddate-time
Rückerstattungszeitpunkt.
externalStatusstring
Externer Status.
Mögliche Werte: [NEW, EXPIRED, PAYMENT_RECEIVED, UNDERPAYMENT_RECEIVED, OVERPAYMENT_RECEIVED, EXPIRED_PAYMENT_RECEIVED, EXPIRED_UNDERPAYMENT_RECEIVED, EXPIRED_OVERPAYMENT_RECEIVED, EXPIRED_PAYMENT_REFUND_REQUESTED, UNDERPAYMENT_REFUND_REQUESTED, EXPIRED_UNDERPAYMENT_REFUND_REQUESTED, OVERPAYMENT_REFUND_REQUESTED, FULL_OVERPAYMENT_REFUND_REQUESTED, EXPIRED_PAYMENT_REFUNDED, UNDERPAYMENT_REFUNDED, OVERPAYMENT_REFUNDED, FULL_OVERPAYMENT_REFUNDED, EXPIRED_PAYMENT_REFUND_CONFIRMATION_REQUIRED, UNDERPAYMENT_REFUND_CONFIRMATION_REQUIRED, EXPIRED_UNDERPAYMENT_REFUND_CONFIRMATION_REQUIRED, OVERPAYMENT_REFUND_CONFIRMATION_REQUIRED, FULL_OVERPAYMENT_REFUND_CONFIRMATION_REQUIRED, CLOSED]
Beispiel: NEW
invoiceStatusstring
Rechnungsstatus.
Mögliche Werte: [NEW, RECEIVED, EXCHANGING, COMPLETED, REFUND_CONFIRMATION, REFUND_REQUESTED, REFUNDED, CLOSED]
Beispiel: NEW
penaltiesstring[]
Strafvermerke.
Mögliche Werte: [EXPIRED, UNDERPAYMENT, OVERPAYMENT]
Beispiel: ["EXPIRED"]
refundTypestring
Rückerstattungsart.
Mögliche Werte: [FULL_REFUND, PARTIAL_REFUND]
Beispiel: FULL_REFUND
cryptoCurrencyAddressstring
Krypto-Adresse.
Beispiel: USD
initialSenderAmountnumber
Ursprünglicher Betrag des Absenders.
Beispiel: 10.25
actualReceivedAmountnumber
Tatsächlich erhaltener Betrag.
Beispiel: 10.25
senderCurrencystring
Währung des Absenders.
Mögliche Werte: [USD, EUR, GBP, RUB, UAH, KZT, BRL, TRY, AZN, ARS, AUD, BDT, CAD, CLP, COP, DOP, EGP, HKD, INR, IDR, JPY, MYR, MXN, MAD, NPR, NZD, PKR, PEN, PHP, SGD, ZAR, KRW, LKR, THB, AED, VND, CNY, CNH, BTC, BNB, BNB_BEP20, BNB_BEP2, BNB_ERC20, BCH, DAI, DOGE, DOGE_DOGENT, DOGE_BEP2, DOGE_BEP20, ETH, LTC, USDP, XRP, SHIB, SHIB_BEP20, SHIB_ERC20, USDT, USDT_BEP20, USDT_ERC20, USDT_TRC20, USDT_SOL, USDT_AVAXC, USDT_POL, USDT_OP, USDT_ARB, TRX, TUSD, USDC, USDC_ERC20, USDC_BEP20, USDC_BEP2, ZEC, BUSD, BUSD_BEP20, BUSD_ERC20, BUSD_TRC20, TON, SOL, ADA, AVAX, DOT, LINK, NEAR, POL, DASH, USDT_TON, USDC_ARB, USDC_OP, USDC_POL, USDC_AVAXC, USDC_SOL]
Beispiel: USD
cryptoCurrencyTransactionIdstring
ID der Krypto-Transaktion.
Beispiel: 11111111-1111-4111-8111-111111111111
refundAddressstring
Rückerstattungsadresse.
Beispiel: test-value

Beispiel

{
  "orderId": "ORDER_123456",
  "sciName": "test-value",
  "paymentStatus": "CREATED",
  "paymentMethod": "CRYPTO_INVOICE",
  "paymentCreated": "2026-01-15T10:30:00",
  "transaction": {
    "status": "success"
  },
  "invoice": {
    "status": "success"
  }
}

400

Ungültige Anfrage. Die Anfrage ist fehlerhaft oder enthält ungültige Parameter.

application/json

Schema

Schema

statusstringerforderlich
Antwortstatus.
Mögliche Werte: [error]
Beispiel: error
data objecterforderlich
Daten der Fehlerantwort.
errors object[]erforderlich
Liste der für die Anfrage zurückgegebenen Fehler.
Array [
errorMessagestringerforderlich
Stabiler maschinenlesbarer Fehlercode.
Beispiel: disabled
errorTypestringerforderlich
Fehlerkategorie.
Beispiel: FORM
errorIdstringerforderlich
Kurze eindeutige Fehlerkennung für Support und Logs.
Beispiel: errTest1234
errorDescriptionstringerforderlich
Lesbare Fehlerbeschreibung.
Beispiel: REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API
errorFieldstringnullable
Feld der Anfrage, auf das sich der Fehler bezieht, falls vorhanden.
Beispiel: null
paramsobject[]erforderlich
Zusätzliche Fehlerparameter.
requestParamsobjecterforderlich
Für die Diagnose erfasste Anfrageparameter.
]

Beispiel

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "disabled",
        "errorType": "FORM",
        "errorId": "errTest1234",
        "errorDescription": "REQUESTED OPERATION IS DISABLED FOR THE MERCHANT API",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

401

Nicht autorisiert. Die Authentifizierungs-Header des Händlers fehlen oder sind ungültig.

application/json

Schema

Schema

statusstringerforderlich
Antwortstatus.
Mögliche Werte: [error]
Beispiel: error
data objecterforderlich
Daten der Fehlerantwort.
errors object[]erforderlich
Liste der für die Anfrage zurückgegebenen Fehler.
Array [
errorMessagestringerforderlich
Stabiler maschinenlesbarer Fehlercode.
Beispiel: userDoesNotExistException
errorTypestringerforderlich
Fehlerkategorie.
Beispiel: GENERAL
errorIdstringerforderlich
Kurze eindeutige Fehlerkennung für Support und Logs.
Beispiel: errTest1234
errorDescriptionstringerforderlich
Lesbare Fehlerbeschreibung.
Beispiel: NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]
errorFieldstringnullable
Feld der Anfrage, auf das sich der Fehler bezieht, falls vorhanden.
Beispiel: null
paramsobject[]erforderlich
Zusätzliche Fehlerparameter.
requestParamsobjecterforderlich
Für die Diagnose erfasste Anfrageparameter.
]

Beispiel

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "userDoesNotExistException",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "NOT FOUND API WITH ACCOUNT_EMAIL: [email protected]",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

404

Nicht gefunden. Die angeforderte Ressource existiert nicht.

application/json

Schema

Schema

statusstringerforderlich
Antwortstatus.
Mögliche Werte: [error]
Beispiel: error
data objecterforderlich
Daten der Fehlerantwort.
errors object[]erforderlich
Liste der für die Anfrage zurückgegebenen Fehler.
Array [
errorMessagestringerforderlich
Stabiler maschinenlesbarer Fehlercode.
Beispiel: resourceNotFound
errorTypestringerforderlich
Fehlerkategorie.
Beispiel: GENERAL
errorIdstringerforderlich
Kurze eindeutige Fehlerkennung für Support und Logs.
Beispiel: errTest1234
errorDescriptionstringerforderlich
Lesbare Fehlerbeschreibung.
Beispiel: Resource not found
errorFieldstringnullable
Feld der Anfrage, auf das sich der Fehler bezieht, falls vorhanden.
Beispiel: null
paramsobject[]erforderlich
Zusätzliche Fehlerparameter.
requestParamsobjecterforderlich
Für die Diagnose erfasste Anfrageparameter.
]

Beispiel

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "resourceNotFound",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Resource not found",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

500

Interner Serverfehler. Unerwarteter Fehler, wenden Sie sich an den Support

application/json

Schema

Schema

statusstringerforderlich
Antwortstatus.
Mögliche Werte: [error]
Beispiel: error
data objecterforderlich
Daten der Fehlerantwort.
errors object[]erforderlich
Liste der für die Anfrage zurückgegebenen Fehler.
Array [
errorMessagestringerforderlich
Stabiler maschinenlesbarer Fehlercode.
Beispiel: internalServerError
errorTypestringerforderlich
Fehlerkategorie.
Beispiel: GENERAL
errorIdstringerforderlich
Kurze eindeutige Fehlerkennung für Support und Logs.
Beispiel: errTest1234
errorDescriptionstringerforderlich
Lesbare Fehlerbeschreibung.
Beispiel: Internal server error
errorFieldstringnullable
Feld der Anfrage, auf das sich der Fehler bezieht, falls vorhanden.
Beispiel: null
paramsobject[]erforderlich
Zusätzliche Fehlerparameter.
requestParamsobjecterforderlich
Für die Diagnose erfasste Anfrageparameter.
]

Beispiel

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "internalServerError",
        "errorType": "GENERAL",
        "errorId": "errTest1234",
        "errorDescription": "Internal server error",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}