Integration mit Ihrem Service

Händler

Auftrag erstellen

Verwenden Sie die Methode public/exchanger/order/create

Name Beschreibung Typ
routeId ID der Richtung ObjectID
partner Partnercode STRING
amount Betrag FLOAT
fromValues[0][key] Schlüsselfeld ObjectID
fromValues[0][value] Wert für das Feld STRING
toValues[0][key] Schlüsselfeld STRING
toValues[0][value] Wert für das Feld STRING
routeValues[0][key] Schlüsselfeld ObjectID
routeValues[0][value] Wert für das Feld STRING
lang Sprache (ukr, eng) STRING
agreement Vereinbarung BOOLEAN
hideOutData Requisiten ausblenden BOOLEAN
clientCallbackUrl Rückruf, wenn die Anwendung abgeschlossen ist; der Kunde sieht eine Schaltfläche zur Rückkehr auf die Website und wird zu dieser URL weitergeleitet ?status=success oder auf ?status=error STRING
ipnUrl URL der Benachrichtigung für Sofortzahlungen (wird bei Statusänderung des Auftrags aufgerufen) STRING
ipnSecret Zeichenfolge zur Erstellung eines sicheren Hashs in der IPN-URL STRING

Die Dokumentation zum Autorisierungssystem finden Sie in Ihrem persönlichen Konto. Weitere Informationen zur Arbeit mit den Methoden und zusätzliche Daten finden Sie auf

IPN (Benachrichtigung über die Änderung des Status der Zahlungsanfrage)

UclientCallbackUrl - {{ $t('page.merchants.clientCallbackUrl') }
UhideOutData - Empfängerdaten ausblenden
UipnUrl - HTTP/HTTPS-Link zur Benachrichtigung Ihres Servers.
UipnSecret - Zufällige Zeichenfolge zur Erstellung einer Anfrage-Signatur (zur Wahrung der Integrität der Anfrage)

Die Anfrage wird per POST gesendet
IPN wird einmalig gesendet
Die Zustellung von IPN ist nicht garantiert (wenn der Server nicht auf die Anfrage antwortet, wird sie nicht erneut gesendet)

Beispiel IPN

POST

['Content-Type'] = 'application/x-www-form-urlencoded'

orderUID :Number() - Auftrag uid
orderId :String(ObjectId) - Auftrag id
newStatus :String() - Auftrag des aktuellen Status
inAmount :String(number) - order in sum
outAmount :String(number) - order out sum
xml_from :String() - Auftrag uid
xml_to :String() - Auftrag uid
timestamp :Number() - Unix-Zeit und IPN-Benachrichtigung
toValues :Array([{key,name,value}]) - Auftragsdaten

Statusliste

new - Neuer Auftrag
waitPayment - Zahlung vom Benutzer erwartet
errorPayment - Fehler bei der Benutzerzahlung (Fehler beim Versand durch den Verkäufer)
inProgress - In Bearbeitung (warten auf Verarbeitung durch den Administrator oder Zahlung des Auftrags)
inProgressPayout - In der Warteschlange zur Zahlung (Zahlung erfolgreich empfangen) (falls eine automatische Zahlung in der Währung eingerichtet ist, wird diese initiiert)
errorPayout - Zahlungsfehler (Fehler bei der Durchführung der Zahlung)
hold - Auftrag eingefroren (Probleme mit der Anwendung)
done - Auftrag erfolgreich ausgezahlt
returned - Auftrag wurde bezahlt, aber nicht alle Austauschbedingungen und Rückgabemethoden des Absenders wurden erfüllt
deleted - Auftrag gelöscht (storniert)

Überprüfung der Prüfsumme der Anfrage (IPN)

sha256(orderId:newStatus:inAmount:outAmount:xml_from:xml_to:timestamp:ipnSecret)

const stringForHash = orderId+":"+newStatus+":"+inAmount+":"+outAmount+":"+xml_from+":"+xml_to+":"+timestamp+":"+ipnSecret; // example string for hash 5d8e6002b80b7b4cd75a6424:inProgress:2:317.42:ETH:WMZ:1571328406072:SECRET123

const hash = crypto.createHash('sha256').update(stringForHash).digest('hex') // example hash af3acf947e6f0e0f2c267e300b8582e504dba12d1f2d058652b7414163c09f48

Zahlungskontrolle

  1. Wenn Sie den Status der Anfragen kontrollieren und diese mithilfe der Autorisierung erstellen müssen, werden alle Anfragen in Ihrem persönlichen Konto angezeigt;
  2. Sie können die UID der Anfrage und das Geheimnis speichern und manuell zur Anfrage navigieren, indem Sie diese Daten in der Adresszeile angeben

Zahlung

  1. Sie können /payment/ verwenden, um die Zahlungsseite anzuzeigen

    // schema
    https://nimlab.eu/user-lang/payment/order-uid/order-secret
    // example result
    https://nimlab.eu/en/payment/1409/dGqwF2M2eBPaSN1G5ljMS1cb
  2. Sie können auch einfach einen Link zur Börse angeben, wie ihn alle Kunden sehen, wobei anstelle von /payment/ /order/ verwendet werden sollte
  3. Die Methode verfügt über Parameter, die es ermöglichen, Zahlungsdaten oder ein Zahlungsformular auf Ihrer Website anzuzeigen, das Sie verwenden können. WICHTIG: Wenn eine Methode mit Vorauszahlung verwendet wird, müssen Sie den Auftragsstatus von waitPayment auf inProgress nach der Zahlung aktualisieren.