Integration mit Ihrem Service

Händler

Auftrag erstellen

Methode verwenden public/exchanger/order/create

Name description Typ
routeId id direkt ObjectID
partner Partnercode STRING
amount Betrag FLOAT
fromValues[0][key] Feldschlüssel ObjectID
fromValues[0][value] Feldwert STRING
toValues[0][key] Feldschlüssel STRING
toValues[0][value] Feldwert STRING
routeValues[0][key] Feldschlüssel ObjectID
routeValues[0][value] Feldwert STRING
lang Sprache STRING
agreement Vereinbarung BOOLEAN
hideOutData Details verbergen BOOLEAN
clientCallbackUrl Rückruf.Wenn das Programm beendet ist, wird eine Schaltfläche angezeigt, um zur Website zurückzukehren, und der Kunde wird zu dieser URL weitergeleitet. ?status=success oder auf ?status=error STRING
ipnUrl URL - Verlinkung zur sofortigen Zahlungsbenachrichtigung (wird aufgerufen, wenn sich der Status der Bestellung ändert) STRING
ipnSecret zu erstellende sichere Zeichenfolge Hash in IPN URL STRING

Systemdokumentation finden Sie in Ihrem persönlichen Kabinett.Erfahren Sie mehr über die weitern Optionen und Daten unter

IPN (Benachrichtigung über Änderungen im Zahlungsstatus)

Um Benachrichtigung über eine Status - Änderung vom Auftrag während der Auftragstellung zu erhalten,ist es notwendig zusätzliche Parameter zu senden:

  • clientCallbackUrl - Rückruf.Wenn das Programm beendet ist, wird eine Schaltfläche angezeigt, um zur Website zurückzukehren, und der Kunde wird zu dieser URL weitergeleitet.
  • hideOutData - Empfänger - Daten verbergen
  • ipnUrl - Der HTTP / HTTPS - Link für die Benachrichtigung vom Ihrem Server.
  • ipnSecret - Zufällige Zeichenfolge zum Unterschrift - Generieren(für Unterstützung von Integrität der Anfrage)
  1. Die Anfrage wird im POST - Verfahren gesendet
  2. IPN wird nur einmal gesendet
  3. IPN - Zustellung ist nicht garantiert(wenn der Server nicht auf die Anfrage geantwortet hat, wird sie nicht erneut gesendet)

Beispiel IPN

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


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

  • new - neue Anfrage
  • waitPayment - Wir warten auf die Zahlung vom Benutzer
  • errorPayment - Fehler bei der Benutzerzahlung ( Fehler seitens Verkäufer )
  • inProgress - Bearbeitung läuft (erwartet wird Auftragsbearbeitung durch Administrator oder Auftragszahlung)
  • inProgressPayout - in der Warteschlange zur Zahlung ( Zahlung akzeptiert erfolgreich ) ( wenn konfiguriert automatisch Zahlung in der Währung , es wird initialisiert )
  • errorPayout - Zahlungsfehler ( ein Fehler während der Zahlung ist passiert)
  • hold - Der Auftrag ist eingefroren ( Probleme mit Anwendung )
  • done - Der Auftrag ist erfolgreich bezahlt
  • returned - Der Auftrag wurde bezahlt, aber nicht alle Bedingungen beim Tausch und Optionen zur Rückerstattung wurden durchgeführt
  • deleted - Auftrag wurde gelöscht(unterbrochen)

Verifizierung der Kontrollsumme von 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. Bei Bedarf können Sie den Status von Anfragen kontrollieren, erstellen Sie mit Hilfe Berechtigungen, alle Anfragen werden dann in Ihrem persönlichen Kabinett angezeigt;
  2. Sie können die UID und das Geheimanfrage speichern dann zur Angabe manuell navigieren und weiter diese Daten in der Adressleiste angeben

Zahlung

  1. Sie können / payment / zum Anzeigen der Zahlungsseite verwenden

    // schema
    https://www.auralegal.com/user-lang/payment/order-uid/order-secret
    // example result
    https://www.auralegal.com/en/payment/1409/dGqwF2M2eBPaSN1G5ljMS1cb
  2. Sie können einfach eine Verlinkung auf die Börse geben, so wie es alle Kunden sehen, nach dem gleichen Schema wie in ersten Optionen, außer / payment / , soll durch / order / ersetzt werden
  3. Das Verfahren hat Parameter, die Zahlungsdetails oder Zahlungsformular auf Ihrer Website zu zeigen erlauben, die Sie benutzen können.WICHTIG: Wenn die Vorauszahlungsverfahren verwendet wird, benötigen Sie den Bestellstatus von waitPayment auf inProgress .nach Bezahlung zu aktualisieren.

Support - Center