Bitcoin Versand API

V 1.0

Contents

Diese Funktion erzeugt eine einzigartige Bitcoin-Adresse, an die der Kunde die Zahlungen senden kann. Diese Adresse beinhaltet keinerlei Limits hinsichtlich von Transaktionen.

Sie können eine Bitcoin-Adresse für einmalige Aufträge oder Daueraufträge einrichten, sowie eine verlinkte Adresse, die mit einem Benutzerkonto verbunden ist. Zum Beispiel, wenn Sie die Adresse wiederverwenden möchten, um das gleiche Produkt noch einmal kaufen möchten oder um die Account-Bilanz aufzurufen.

Bitte beachten Sie, dass geringfügige Zahlungen nicht effizient sind, aufgrund der hohen Netzwerk-Gebühren.

HTTP und HTTPs Protokolle in URL sind erforderlich. Also, fordern wir einen Callback an von TOR project logo Netzwerk.

Als Zieladresse können Sie jede Art von existierende Bitcoin-Adresse angeben: Standard-Adressen, die mit "1" (P2PKH) anfangen ; Zahlen sie an Script-Hash-Adresse mit dem SegWit-Support (P2SH-P2WPKH), die mit "3" anfangen; so wie eine neue SegWit- Adresse, die mit "bc" (P2WPKH) anfängt.

 

Einfache Anfrage:

Beispiel-Code

  1. <?php
  2.     $my_address = "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4";
  3.     $my_callback_url = "http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9";
  4.     $api_base = "https://apirone.com/api/v1/receive";
  5.  
  6.     $curl = curl_init();
  7.     curl_setopt_array($curl, array(
  8.         CURLOPT_RETURNTRANSFER => 1,
  9.         CURLOPT_URL => $api_base . "?method=create&address=" . $my_address . "&callback=" . urlencode($my_callback_url)
  10.     ));
  11.     $response = curl_exec($curl);
  12.     $http_status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
  13.     curl_close($curl);
  14.  
  15.     if ($http_status_code == 200) {
  16.         $decoded = json_decode($response, true);
  17.         echo "Please send the payment to the following bitcoin address: " . $decoded["input_address"];
  18.     } else {
  19.         echo "Sorry, an error occurred: " . $response;
  20.     }
  21. ?>
  1. <?php
  2.   $my_address = "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4";
  3.   $my_callback_url = urlencode("http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9");
  4.   $data = file_get_contents("https://apirone.com/api/v1/receive?method=create&address=". $my_address. "&callback=" . $my_callback_url);
  5.   $respond = json_decode($data,true);
  6.   $address = $respond["input_address"]; // bitcoin address for customer payments
  7.   echo $address;
  8. ?>
  1. import requests
  2. import urllib
  3. my_address = 'bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4'
  4. my_callback_url = urllib.parse.urlencode({"r":"http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9"})[2:]
  5. url = 'https://apirone.com/api/v1/receive?method=create&address=%s&callback=%s' % (my_address, my_callback_url)
  6. response = requests.get(url)
  7. print(response.text)
Methode und Variablen:
Parameter Beschreibung Bei Bedarf Experiment mit einem Beispielwert
method=create

Diese Methode generiert eine neue Depositenadresse

Bei Bedarf
{address}
base58,
32 Zeichen

Zieladresse
Ihre Zieladresse an die bestätigte Zahlungen gesendet werden

Bei Bedarf
{callback}
Text,
=< 1024 Zeichen

Callback URL')}}
Ihre Server's Callback URL zum Datenempfang Ihrer Zahlung. Sie können optional GET Parameter hinzufügen. Das muss jedoch eine geprüfte URL sein.
Die Callback URL sollte eine verschlüsselte URL sein. Anderenfalls wird sie mit Error zurück gesendet.

Bei Bedarf
  Werte löschen Nachricht senden
Warte auf Zahlung des Kunden:
{ "fee_percent": 1, "destination": "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4", "input_address": "1FEGJSLDJJ6oSuJwur3fCD7TtQbYUjBV4z", "callback_url": "http://example.com/addbalance.php?user=118" }

Erfolgreiche Antwort

Eine erfolgreiche Antwort wird im JSON Format zurück gesendet:
Parameter Beschreibung Typ (Länge)
{fee_percent} Prozentpunkte, die als eine Service Gebühr genutzt werden . Standardwert: 1 Moral
{destination} Händler's Zieladresse ( Bitcoin-Adresse), an die bestätigte Zahlungen weitergeleitet werden base58 (32 Zeichen)
{input_address} Die erstellte Bitcoin-Adresse zum Erhalten einer Zahlung eines Kunden. base58 (32 Zeichen)
{callback_url} Der Server-Callback zum Erhalten der Daten über die Zahlung. Text (max. 1024 Zeichen)
Beispiel Antwort:
{
    "destination": "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4",
    "input_address": "1FEGJSLDJJ6oSuJwur3fCD7TtQbYUjBV4z",
    "callback_url": "http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9"
}

Antwort Fehler

Die "Fehler"-Mitteilung wird im folgendem Textformat angezeigt:
Die verwendete Adresse ist keine gültige Bitcoin-Adresse.
Die verwendete Callback URL ist nicht gültig.
Falsche Funktion.
Nicht genügend Parameter verwendet.
Fehlerhafter Adressentyp.