edigicash Express API Version 1.5

Transkript

1 edigicash Express API Version 1.5 edigicash Express ist leicht in Ihrer Website oder Blog zu integrieren. Die API ist sprachunabhängig und kann in einfachem HTML eingesetzt werden. Grundsätzlich haben Sie zwei Möglichkeiten, die API zu verwenden: Sie können HTML-Formulare in Ihren Webseiten einbauen, oder Sie können Links (statisch oder dynamisch) erzeugen und sie dann in Ihrer Website oder s einfügen. Natürlich können Sie beide Methoden kombinieren. Zusätzlich ermöglicht die API, zwischen den Test-Netzen (Bitcoin und Litecoin Testnets) und der Live-Umgebung umzuschalten. In der Testumgebung haben Sie die Möglichkeit, Ihre Implementierung mit Test-Coins zu validieren. Diese sind im Internet frei verfügbar (Testnet "faucets"). Für die Kommunikation zwischen Händler-Website und dem Gateway-Server, müssen HTTP(S)/POST-Requests verwendet werden. Obwohl nicht zwingend erforderlich, ist SSL (HTTPS) zu empfehlen. Revision: Page 1/24

2 Änderungsübersicht Datum Beschreibung Revision Erste Version Spanisch zugefügt XCurrency Krypto-Währung unterstützt BitcoinDark Krypto-Währung unterstützt Auto-Exchange-Funktion unterstützt Tippfehlerkorrektur. AUTO_EXCHANGE durch EDC_AUTO_EXCHANGE ersetzt Neue EDC_REQ_ALL_NONCE und EDC_REQ_ALL_HMAC Parameter zu Zahlungsanfrage hinzugefügt um alle Felder zu schützen, einschließlich Benutzerfelder EDC_RESP_ALL_NONCE und EDC_RESP_ALL_HMAC Felder zu NOTIFY Gateway-Anwort hinzugefügt Sollten die EDC_REQUEST_HASH, EDC_REQUEST_HMAC und EDC_REQ_ALL_HMAC Felder nicht vorhanden sein, wird die Transaktion als verdächtigt gekennzeichnet (EDC_SUSPICIOUS=Y in NOTIFY Gateway-Antwort) Korrekturen betreffend EDC_REQ_ALL_HMAC Revision: Page 2/24

3 Zahlungsanfrage HTML-Formular HTML-Feld Inhalt Pflichtfeld EDC_ACTION Muss payment sein Ja EDC_VERSION API-Version. 1.5 muss angegeben werden Ja EDC_BTC_ADDRESS EDC_LTC_ADDRESS EDC_PPC_ADDRESS EDC_DOGE_ADDRESS EDC_VTC_ADDRESS EDC_DRK_ADDRESS EDC_XC_ADDRESS EDC_BTCD_ADDRESS Die Bitcoin Händler-Adresse, an die die Zahlung gehen wird. Wenn leer oder nicht vorhanden, wird Bitcoin Zahlung nicht angeboten Die Litecoin Händler-Adresse, an die die Zahlung gehen wird. Wenn leer oder nicht vorhanden, wird Litecoin Zahlung nicht angeboten Die Peercoin Händler-Adresse, an die die Zahlung gehen wird. Wenn leer oder nicht vorhanden, wird Peercoin Zahlung nicht angeboten Die Dogecoin Händler-Adresse, an die die Zahlung gehen wird. Wenn leer oder nicht vorhanden, wird Dogecoin Zahlung nicht angeboten Die Vertcoin Händler-Adresse, an die die Zahlung gehen wird. Wenn leer oder nicht vorhanden, wird Vertcoin Zahlung nicht angeboten Die Darkcoin Händler-Adresse, an die die Zahlung gehen wird. Wenn leer oder nicht vorhanden, wird Darkcoin Zahlung nicht angeboten Die XCurrency Händler-Adresse, an die die Zahlung gehen wird. Wenn leer oder nicht vorhanden, wird XCurrency Zahlung nicht angeboten Die BitcoinDark Händler-Adresse, an die die Zahlung gehen wird. Wenn leer oder nicht vorhanden, wird BitcoinDark Zahlung nicht angeboten Nein (1) Nein (1) Nein (1) Nein (1) Nein (1) Nein (1) Nein (1) Nein (1) Revision: Page 3/24

4 AUTO_EXCHANGE EDC_AMOUNT Y oder N. Defaultwert= N Y =Auto-Exchange aktiviert N =Auto-Exchange deaktiviert Rechnungsbetrag. Achtung: Als Dezimaltrennzeichen muss der Dezimalpunkt (".") verwendet werden! EDC_CURRENCY Rechnungswährung. Muss eine unterstützte Währung sein (siehe Liste unten) Ja EDC_API_ID Die Händler-API-ID (von der APIKey -Seite) Ja EDC_TEST Test Transaktion? "Y" oder "N". Defaultwert ist "N" (Produktion) Nein EDC_CONFIRMATIONS Anzahl der Bestätigungen (0 20), Defaultwert ist 6 Nein EDC_NOTIFY_ALL Y oder N. Defaultwert= N Y =Alle Bestätigungen weiterleiten (0-[EDC_CONFIRMATIONS]) N =Benachrichtigen erst, wenn [EDC_CONFIRMATIONS] Bestätigungen empfangen wurden EDC_MEMO Verwendungszweck. Wird auf der Zahlungsseite angezeigt Nein EDC_LOGO_URL EDC_NOTIFY_URL Logo, dass auf der Zahlungsseite angezeigt wird. Falls vorhanden, muß die URL das gleiche Protokoll benutzen wie die Anfrage selbst ( http oder https ), andernfalls wird sie ignoriert Die URL, an die Zahlungsbenachrichtigungen gesendet werden sollen. Benachrichtigungen werden als Hintergrund HTTPS/POST-Requests übermittelt Nein Ja Nein Nein Nein EDC_PAYMENT_URL EDC_NOPAYMENT_URL Wichtig: Verwenden Sie nicht "localhost" als Hostname. Verwenden Sie stattdessen eine IP-Adresse oder einen Domainname. "localhost" wird vom Gateway abgelehnt! Die URL an die der Käufer nach erfolgreicher Zahlung umgeleitet wird. Ist der Parameter nicht angegeben, wird eine Standartseite angezeigt Die URL an die der Käufer nach fehlgeschlagener Zahlung umgeleitet wird. Ist der Parameter nicht angegeben, wird eine Standartseite angezeigt Nein Nein Revision: Page 4/24

5 EDC_NOTIFY_ -Adresse, die für Zahlungsbenachrichtigungen verwendet werden soll Nein EDC_USER_1 Benutzerdefiniertes Feld 1 (wird mit den Gateway-Antworten unverändert zurückgeschickt) Nein EDC_USER_2 Benutzerdefiniertes Feld 2 (wird mit den Gateway-Antworten unverändert zurückgeschickt) Nein EDC_USER_3 Benutzerdefiniertes Feld 3 (wird mit den Gateway-Antworten unverändert zurückgeschickt) Nein EDC_USER_4 Benutzerdefiniertes Feld 4 (wird mit den Gateway-Antworten unverändert zurückgeschickt) Nein EDC_USER_5 Benutzerdefiniertes Feld 5 (wird mit den Gateway-Antworten unverändert zurückgeschickt) Nein EDC_LANG Sprache der Benutzeroberfläche: en, de, fr oder es. Defaultwert ist en Nein EDC_REQUEST_HASH Die digitale Signatur (Hash). Wird von dem Gateway geprüft, um sicher zu stellen, dass die übertragenen Daten nicht manipuliert wurden. Die Signatur ist nicht vorgeschrieben, aber zu empfehlen. Um den Hash zu berechnen, verketten Sie folgenden Felder in der angegebenen Reihenfolge, getrennt durch einen ":" (Doppelpunkt): EDC_ACTION (EDC_BTC_ADDRESS falls vorhanden) (EDC_LTC_ADDRESS falls vorhanden) (EDC_PPC_ADDRESS falls vorhanden) (EDC_DOGE_ADDRESS falls vorhanden) (EDC_VTC_ADDRESS falls vorhanden) (EDC_DRK_ADDRESS falls vorhanden) (EDC_XC_ADDRESS falls vorhanden) (EDC_BTCD_ADDRESS falls vorhanden) EDC_AMOUNT EDC_CURRENCY EDC_API_ID EDC_TEST EDC_CONFIRMATIONS [api_key] Nein Revision: Page 5/24

6 EDC_REQUEST_HMAC Beispiel: payment:mudswy2fdq2v7gdywomacfdrpjeympinuz:0.10:usd: :y:6:gtuzn674frdfw o0b Dann berechnen Sie den SHA256-Hash-Wert für die Zeichenfolge. Beispiel: 41eee54ac15725fee1131fc899b85e2ec07f6d38e c6782bd31030f99 Anmerkung: Obwohl noch unterstützt, ist dieses Feld jetzt obsolet. Stattdessen sollte EDC_REQ_ALL_HMAC benutzt werden Die HMAC-SHA256-Alternative zu dem EDC_REQUEST_HASH -Feld. Diese Variante sollte wenn möglich verwendet werden. Die Signatur ist nicht vorgeschrieben, aber sehr zu empfehlen. Um den Hash-Wert zu berechnen, verketten Sie folgenden Felder in der angegebenen Reihenfolge, getrennt durch einen ":" (Doppelpunkt): EDC_ACTION (EDC_BTC_ADDRESS falls vorhanden) (EDC_LTC_ADDRESS falls vorhanden) (EDC_PPC_ADDRESS falls vorhanden) (EDC_DOGE_ADDRESS falls vorhanden) (EDC_VTC_ADDRESS falls vorhanden) (EDC_DRK_ADDRESS falls vorhanden) (EDC_XC_ADDRESS falls vorhanden) (EDC_BTCD_ADDRESS falls vorhanden) EDC_AMOUNT EDC_CURRENCY EDC_API_ID EDC_TEST EDC_CONFIRMATIONS Nein Revision: Page 6/24

7 EDC_REQ_ALL_NONCE EDC_REQ_ALL_HMAC Dann berechnen Sie den HMAC-SHA256-Hash-Wert für die Zeichenfolge mit Ihrem [api_key] als geheimer Schlüssel. Anmerkung: Obwohl noch unterstützt, ist dieses Feld jetzt obsolet. Stattdessen sollte EDC_REQ_ALL_HMAC benutzt werden Eine einmalige Zeichenkette, z.b. ein Zeitstempel (in Millisekunden) oder zufallsbedingte Zeichenfolge (maximale Länge ist 64 Zeichen). Dieses Feld ist erforderlich, sobald EDC_REQ_ALL_HMAC benutzt wird Dieses Feld ersetzt die EDC_REQUEST_HASH und EDC_REQUEST_HASH Felder. Die Signatur ist nicht vorgeschrieben, aber dringend empfohlen. Sollten die EDC_REQUEST_HASH, EDC_REQUEST_HMAC und EDC_REQ_ALL_HMAC Felder nicht vorhanden sein, wird die Transaktion als verdächtigt gekennzeichnet. Um den Hash-Wert zu berechnen, verketten Sie folgenden Felder in der angegebenen Reihenfolge, getrennt durch einen ":" (Doppelpunkt): EDC_ACTION (EDC_BTC_ADDRESS falls vorhanden) (EDC_LTC_ADDRESS falls vorhanden) (EDC_PPC_ADDRESS falls vorhanden) (EDC_DOGE_ADDRESS falls vorhanden) (EDC_VTC_ADDRESS falls vorhanden) (EDC_DRK_ADDRESS falls vorhanden) (EDC_XC_ADDRESS falls vorhanden) (EDC_BTCD_ADDRESS falls vorhanden) EDC_AMOUNT EDC_CURRENCY EDC_API_ID (EDC_TEST falls vorhanden) (EDC_CONFIRMATIONS falls vorhanden) EDC_VERSION Ja (2) Nein Revision: Page 7/24

8 (EDC_AUTO_EXCHANGE falls vorhanden) (EDC_NOTIFY_ALL falls vorhanden) (EDC_MEMO falls vorhanden) (EDC_LOGO_URL falls vorhanden) (EDC_NOTIFY_URL falls vorhanden) (EDC_PAYMENT_URL falls vorhanden) (EDC_NOPAYMENT_URL falls vorhanden) (EDC_NOTIFY_ falls vorhanden) (EDC_USER_1 falls vorhanden) (EDC_USER_2 falls vorhanden) (EDC_USER_3 falls vorhanden) (EDC_USER_4 falls vorhanden) (EDC_USER_5 falls vorhanden) EDC_REQ_ALL_NONCE Dann berechnen Sie den HMAC-SHA256-Hash-Wert für die Zeichenfolge mit Ihrem [api_key] als geheimer Schlüssel. (1) : Mindestens eine von diesen Adressen muss vorhanden sein (2) : Pflichtfeld wenn EDC_REQ_ALL_HMAC vorhanden ist Sehr wichtig: Vergessen Sie nicht, Ihre Bitcoin/Litecoin Adressen zu ändern, bevor Sie zwischen den Test- und Produktion Umgebungen wechseln. Bitte genau nachprüfen! Zahlungsanfragen müssen an folgenden URLs geleitet werden: oder (empfohlen!) Revision: Page 8/24

9 Revision: Page 9/24

10 Beispiel: <form action=" method="post" accept charset="utf 8"> <input type="hidden" name="edc_action" value="payment" /> <input type="hidden" name="edc_btc_address" value="1gbtxvvzwb5wxf9yrhzmvxkjbt3k27eir6" /> <input type="hidden" name="edc_doge_address" value="d96cc9fxmuwqegh8mcve7cijyxdcvn1qqu" /> <input type="hidden" name="edc_drk_address" value="xhvm4rmjxjnrykzyi8ypj12bv6usmsr3hu" /> <input type="hidden" name="edc_amount" value="29.95" /> <input type="hidden" name="edc_currency" value="cad" /> <input type="hidden" name="edc_api_id" value="zv6cio56tn" /> <input type="hidden" name="edc_test" value="n" /> <input type="hidden" name="edc_confirmations" value="3" /> <input type="hidden" name="edc_notify_all" value="y" /> <input type="hidden" name="edc_memo" value="this is a LIVE payment" /> <input type="hidden" name="edc_logo_url" value="" /> <input type="hidden" name="edc_notify_url" value=" /> <input type="hidden" name="edc_payment_url" value=" /> <input type="hidden" name="edc_nopayment_url" value=" /> <input type="hidden" name="edc_notify_ " value="sales@mywebsite.com" /> <input type="hidden" name="edc_user_1" value="value 1" /> <input type="hidden" name="edc_user_2" value="value 2" /> <input type="hidden" name="edc_user_3" value="value 3" /> <input type="hidden" name="edc_user_4" value="value 4" /> <input type="hidden" name="edc_user_5" value="value 5" /> <input type="hidden" name="edc_request_hash" value="859dce88d9ad92c89a aa4a5f1f10c22071cf56997c41c4777f37ff5" /> <input type="hidden" name="edc_lang" value="en" /> <input type="hidden" name="edc_version" value="1.5" /> <input type="submit" name="submit" value="buy Now..." /> </form> Revision: Page 10/24

11 Zahlungsanfrage NOTIFY Gateway-Anwort HTML Feld Inhalt Pflichtfeld EDC_ACTION payment Ja EDC_API_ID Wie im Request-Formular Ja EDC_REQ_AMOUNT Rechnungsbetrag (aus dem Request-Formular) Ja EDC_REQ_CURRENCY Rechnungswährung (aus dem Request-Formular) Ja EDC_EXCHANGE_RATE Wechselkurs Ja EDC_MEMO Wie im Request-Formular, oder leer Ja EDC_PROXY_ADDRESS Proxy (temporäre) Adresse, die vom Käufer benutzt wurde Ja EDC_TO_ADDRESS Händler-Adresse, an die die Zahlung gehen wird Ja EDC_AMOUNT Zahlungsbetrag Ja EDC_CURRENCY Zahlungswährung ( BTC, LTC, PPC, XDG (DOGE), VTC, DRK, X11 (XC), BTD (BTCD)) Ja EDC_CONFIRMATIONS Anzahl der Bestätigungen bisher Ja EDC_REQUEST_ID Einmalige Request-ID (vom Gateway generiert) Ja EDC_TIMESTAMP Datum und Uhrzeit der Anforderung, in ISO 8601 UTC Format (JJJJ-MM-TT HH:mm:ss) Ja EDC_SUSPICIOUS Y wenn die Transaktion manuell überprüft werden sollte, sonst N Ja EDC_SUSPICIOUS_MSG A Fehlermeldung falls EDC_SUSPICIOUS= Y, sonst leer Ja Revision: Page 11/24

12 EDC_RESPONSE_HASH Die Signatur (Hash), die vom Gateway generiert wurde. Vorhanden wenn EDC_REQUEST_HASH im Formular vorhanden war. Um den Hash zu überprüfen, verketten Sie folgenden Felder in der angegebenen Reihenfolge, getrennt durch einen ":"(Doppelpunkt): EDC_ACTION EDC_REQ_AMOUNT EDC_REQ_CURRENCY EDC_EXCHANGE_RATE EDC_TO_ADDRESS EDC_PROXY_ADDRESS EDC_AMOUNT EDC_CURRENCY EDC_CONFIRMATIONS EDC_REQUEST_ID EDC_TIMESTAMP EDC_SUSPICIOUS [api_key] Ja (1) Dann berechnen Sie den SHA256-Hash-Wert für die Zeichenfolge. Das Ergebnis sollte den EDC_RESPONSE_HASH Feldwert entsprechen. EDC_LANG Wie im Request-Formular, oder Defaultwert ( en ) Ja EDC_USER_1 Wie im Request-Formular, oder leer Ja EDC_USER_2 Wie im Request-Formular, oder leer Ja EDC_USER_3 Wie im Request-Formular, oder leer Ja EDC_USER_4 Wie im Request-Formular, oder leer Ja EDC_USER_5 Wie im Request-Formular, oder leer Ja Revision: Page 12/24

13 EDC_RESPONSE_HMAC Die HMAC-SHA256 Signatur (Hash), die vom Gateway generiert wurde. Vorhanden wenn EDC_REQUEST_HMAC im Formular vorhanden war. Um den Hash-Wert zu überprüfen, verketten Sie folgenden Felder in der angegebenen Reihenfolge, getrennt durch einen ":"(Doppelpunkt): EDC_ACTION EDC_REQ_AMOUNT EDC_REQ_CURRENCY EDC_EXCHANGE_RATE EDC_TO_ADDRESS EDC_PROXY_ADDRESS EDC_AMOUNT EDC_CURRENCY EDC_CONFIRMATIONS EDC_REQUEST_ID EDC_TIMESTAMP EDC_SUSPICIOUS Ja (1) Dann berechnen Sie die Zeichenfolge mit dem HMAC-SHA256-Algorithmus und Ihrem [api_key] als geheimer Schlüssel. Das Ergebnis sollte den EDC_RESPONSE_HMAC Feldwert entsprechen. EDC_RESP_ALL_NONCE Eine einmalige, vom Server generierte Zeichenkette Ja Revision: Page 13/24

14 EDC_RESP_ALL_HMAC Eine erweiterte HMAC-SHA256 Signatur (Hash), die vom Gateway generiert wurde. Das Feld ist immer vorhanden. Um den Hash-Wert zu überprüfen, verketten Sie folgenden Felder in der angegebenen Reihenfolge, getrennt durch einen ":"(Doppelpunkt): EDC_ACTION EDC_REQ_AMOUNT EDC_REQ_CURRENCY EDC_EXCHANGE_RATE EDC_TO_ADDRESS EDC_PROXY_ADDRESS EDC_AMOUNT EDC_CURRENCY EDC_CONFIRMATIONS EDC_REQUEST_ID EDC_TIMESTAMP EDC_SUSPICIOUS EDC_SUSPICIOUS_MSG EDC_API_ID EDC_MEMO EDC_USER_1 EDC_USER_2 EDC_USER_3 EDC_USER_4 EDC_USER_5 EDC_RESP_ALL_NONCE Dann berechnen Sie die Zeichenfolge mit dem HMAC-SHA256-Algorithmus und Ihrem [api_key] als geheimer Schlüssel. Das Ergebnis sollte dem EDC_RESP_ALL_HMAC Inhalt entsprechen. Ja Revision: Page 14/24

15 (1) : Wenn ein HASH/HMAC Feld im Request vorhanden ist, ist einer von diesen Felder auch vorhanden Notiz 1: Um eine erfolgreiche Verarbeitung zu bestätigen, muß das Callback-Skript mit einem 200 oder 202 HTTP Statuscode antworten und "OK" als Text zurückschicken. Andernfalls wird das Gateway die Prozedur alle 30 Sekunden und bis zu 100-mal wiederholen. Beispiel (PHP): header('http/ OK'); ob_end_clean(); echo 'OK'; exit(); Notiz 2: Das Feld EDC_RESPONSE_HASH oder EDC_RESP_ALL_HMAC, das von dem Gateway zurückgegeben wird, sollte immer überprüft werden, um sicher zu stellen, daß die übertragenen Daten nicht manipuliert worden sind. Die Signatur wird durch Verknüpfung bestimmter Parameter und dem API-Key erstellt. Der API-Key ist nur dem Händler und dem Gateway bekannt. Die Signatur wird dann unter Verwendung des SHA256 Algorithmus generiert. EDC_RESP_ALL_HMAC ist die empfohlene Methode, um zu prüfen dass ALLE Felder korrekt sind. EDC_RESPONSE_HASH schützt die EDC_USER_x Felder nicht, und sollte nur verwendet werden, wenn HMAC-SHA256 nicht verfügbar ist. Revision: Page 15/24

16 Zahlungsanfrage PAYMENT Gateway-Antwort HTML Feld Inhalt Pflichtfeld EDC_ACTION payment Ja EDC_API_ID Wie im Request-Formular Ja EDC_REQ_AMOUNT Rechnungsbetrag (aus dem Request-Formular) Ja EDC_REQ_CURRENCY Rechnungswährung (aus dem Request-Formular) Ja EDC_EXCHANGE_RATE Wechselkurs Ja EDC_MEMO Wie im Request-Formular, oder leer Ja EDC_PROXY_ADDRESS Proxy (temporäre) Adresse, die vom Käufer benutzt wurde Ja EDC_TO_ADDRESS Händler-Adresse, an die die Zahlung gehen wird Ja EDC_AMOUNT Zahlungsbetrag Ja EDC_CURRENCY Zahlungswährung ( BTC, LTC, PPC, XDG (DOGE), VTC, DRK, X11 (XC), BTD (BTCD)) Ja EDC_CONFIRMATIONS Anzahl der Bestätigungen bisher Ja EDC_REQUEST_ID Einmalige Request-ID (vom Gateway generiert) Ja EDC_TIMESTAMP Datum und Uhrzeit der Anforderung, in ISO 8601 UTC Format (JJJJ MM TT HH:mm:ss) Ja EDC_LANG Wie im Request-Formular, oder Defaultwert ( en ) Ja EDC_USER_1 Wie im Request-Formular, oder leer Ja EDC_USER_2 Wie im Request-Formular, oder leer Ja Revision: Page 16/24

17 EDC_USER_3 Wie im Request-Formular, oder leer Ja EDC_USER_4 Wie im Request-Formular, oder leer Ja EDC_USER_5 Wie im Request-Formular, oder leer Ja Revision: Page 17/24

18 Zahlungsanfrage NOPAYMENT Gateway-Antwort HTML Feld Inhalt Pflichtfeld EDC_ACTION payment Ja EDC_API_ID Wie im Request-Formular Ja EDC_REQ_AMOUNT Rechnungsbetrag (aus dem Request-Formular) Ja EDC_REQ_CURRENCY Rechnungswährung (aus dem Request-Formular) Ja EDC_MEMO Wie im Request-Formular, oder leer Ja EDC_LANG Wie im Request-Formular, oder Defaultwert ( en ) Ja EDC_USER_1 Wie im Request-Formular, oder leer Ja EDC_USER_2 Wie im Request-Formular, oder leer Ja EDC_USER_3 Wie im Request-Formular, oder leer Ja EDC_USER_4 Wie im Request-Formular, oder leer Ja EDC_USER_5 Wie im Request-Formular, oder leer Ja Revision: Page 18/24

19 GETLINK Requests Ein GetLink Request kann verwendet werden, um Zahlungs-Links zu erzeugen. Zahlungs-Links können in Web-Seiten oder s eingebaut werden. Damit kann man wirksame "Calls-To-Action" in -Kampagnen oder Landeseiten integrieren. Einen Link zu generieren ist ähnlich wie das Senden einer Zahlungsanfrage, mit der Ausnahme, dass im EDC_ACTION Feld "getlink" statt "payment" angegeben werden soll. GetLink-Requests müssen an folgenden URLs geleitet werden: oder (empfohlen!) Beispiel: <form action=" method="post" accept charset="utf 8"> <input type="hidden" name="edc_action" value="getlink" /> <input type="hidden" name="edc_btc_address" value="1gbtxvvzwb5wxf9yrhzmvxkjbt3k27eir6" /> <input type="hidden" name="edc_doge_address" value="d96cc9fxmuwqegh8mcve7cijyxdcvn1qqu" /> <input type="hidden" name="edc_drk_address" value="xhvm4rmjxjnrykzyi8ypj12bv6usmsr3hu" /> <input type="hidden" name="edc_amount" value="29.95" /> <input type="hidden" name="edc_currency" value="cad" /> <input type="hidden" name="edc_api_id" value="zv6cio56tn" /> <input type="hidden" name="edc_test" value="n" /> <input type="hidden" name="edc_confirmations" value="3" /> <input type="hidden" name="edc_notify_all" value="y" /> <input type="hidden" name="edc_memo" value="this is a LIVE payment" /> <input type="hidden" name="edc_logo_url" value="" /> <input type="hidden" name="edc_notify_url" value=" /> Revision: Page 19/24

20 <input type="hidden" name="edc_payment_url" value=" /> <input type="hidden" name="edc_nopayment_url" value=" /> <input type="hidden" name="edc_notify_ " /> <input type="hidden" name="edc_user_1" value="value 1" /> <input type="hidden" name="edc_user_2" value="value 2" /> <input type="hidden" name="edc_user_3" value="value 3" /> <input type="hidden" name="edc_user_4" value="value 4" /> <input type="hidden" name="edc_user_5" value="value 5" /> <input type="hidden" name="edc_request_hash" value="cfb3f1ab7a6c2ea525b864878c718f037b9084d1cccff9025b749b6de47246f6" /> <input type="hidden" name="edc_lang" value="en" /> <input type="hidden" name="edc_version" value="1.5" /> <input type="submit" name="submit" value="generate Link..." /> </form> Das Gateway schickt eine JSON Antwort mit folgenden Felder zurück: JSON-Feld Inhalt Pflichtfeld status OK oder ERROR Ja message Wenn status= ERROR, die Fehlermeldung, sonst leer Ja link Wenn status= OK, der generierte Link, sonst leer Ja Revision: Page 20/24

21 response_hash Die Signatur (Hash), die vom Gateway generiert wurde. Um den Hash zu überprüfen, verketten Sie folgenden Felder in der angegebenen Reihenfolge, getrennt durch einen ":" (Doppelpunkt): status message link [api_key] Ja Dann berechnen Sie den SHA256-Hash-Wert für die Zeichenfolge. Das Ergebnis sollte den response_hash Feldwert entsprechen. user_1 Wie im Request-Formular (EDC_USER_1), oder leer Ja user_2 Wie im Request-Formular (EDC_USER_2), oder leer Ja user_3 Wie im Request-Formular (EDC_USER_3), oder leer Ja user_4 Wie im Request-Formular (EDC_USER_4), oder leer Ja user_5 Wie im Request-Formular (EDC_USER_5), oder leer Ja Einmal erzeugt, verhält sich ein Link genau wie ein Zahlungsformular. Revision: Page 21/24

22 Unterstützte Währungen CAD CHF CNY EUR GBP JPY USD BTC DRK LTC PPC VTC XDG X11 BTD AED ANG ARS AUD BGN BRL BSD Canadian dollar Swiss franc Yuan renminbi European Union euro Great British Pound Japanese yen United States dollar Bitcoin Darkcoin Litecoin Peercoin Vertcoin Dogecoin XCurrency BitcoinDark United Arab Emirates dirham Netherlands Antillian guilder Argentine peso Australian dollar Bulgarian lev Brazilian real Bahamian dollar Revision: Page 22/24

23 CLP COP CSD CZK DKK FJD GHC GTQ HKD HNL HRK HUF IDR ILS INR JMD KRW LKR LTL LVL MAD MDL MMK MXN MYR NOK NZD Chilean peso Colombian peso Serbian dinar Czech koruna Danish krone Fijian dollar Ghana cedi Guatemalan quetzal Hong Kong dollar Honduran lempira Croatian kuna Hungarian forint Indonesian rupiah New Israeli shekel Indian rupee Jamaican dollar South Korean won Sri Lankan rupee Lithuanian litas Latvian lat Moroccan dirham Moldovan leu Myanmar kyat Mexican peso Malaysian ringgit Norwegian krone New Zealand dollar Revision: Page 23/24

24 PAB PEN PHP PKR PLN RON RUB SEK SGD THB TND TRY TTD TWD VEB VND XAF XCD XPF ZAR Panamanian balboa Peruvian nuevo sol Philippine peso Pakistani rupee Polish zloty Romanian new leu Russian ruble Swedish krona Singapore dollar Thai baht Tunisian dinar New Turkish lira Trinidad and Tobago dollar New Taiwan dollar Venezuelan bolivar Viet Nam dong CFA franc BEAC East Caribbean dollar CFP franc South African rand Revision: Page 24/24