Coinbase Commerce API v PHP: Kompletný sprievodca

Coinbase Commerce API je mocný nástroj, ktorý umožňuje obchodníkom prijímať platby v kryptomenách priamo na svojej webovej stránke alebo v e-shopoch. Tento článok vás podrobne prevedie integráciou Coinbase Commerce API do PHP aplikácie. Prejdeme si všetky kroky, vrátane nastavenia, základných operácií a príkladov kódu.

Úvod do Coinbase Commerce API

Coinbase Commerce je služba poskytovaná spoločnosťou Coinbase, ktorá umožňuje obchodníkom prijímať platby v rôznych kryptomenách, ako sú Bitcoin, Ethereum, Litecoin a ďalšie. Pomocou API môžete integrovať platby priamo do svojho systému.

Získanie API kľúča

1. Prihláste sa do Coinbase Commerce: Ak ešte nemáte účet, zaregistrujte sa na stránke Coinbase Commerce.
2. Vytvorte novú aplikáciu: Po prihlásení sa do svojho účtu kliknite na „Settings“ a potom na „API keys“.
3. Generujte nový API kľúč: Kliknite na „Create API Key“ a uložte si vygenerovaný kľúč, ktorý budete používať na autentifikáciu API požiadaviek.

Nastavenie prostredia

Predtým, než začneme s implementáciou, je potrebné nainštalovať PHP knižnice a nastaviť prostredie.

1. Inštalácia Composer: Composer je nástroj na správu závislostí v PHP. Ak ho ešte nemáte, môžete si ho nainštalovať podľa pokynov na oficiálnej stránke Composeru.

2. Inštalácia knižnice Coinbase Commerce PHP: Použite Composer na inštaláciu knižnice Coinbase Commerce PHP. Spustite nasledujúci príkaz v termináli:

   bash
   composer require coinbase/coinbase-commerce
   

Základné operácie s API

1. Iniciálizácia API klienta

php

require 'vendor/autoload.php';

use CoinbaseCommerce\ApiClient;
use CoinbaseCommerce\Resources\Charge;

$apiKey = 'YOUR_API_KEY';
ApiClient::init($apiKey);

2. Vytvorenie novej platby (Charge)

php

require 'vendor/autoload.php';

use CoinbaseCommerce\ApiClient;
use CoinbaseCommerce\Resources\Charge;

ApiClient::init($apiKey);

$chargeData = [
    'name' => 'Test Charge',
    'description' => 'Description for test charge',
    'local_price' => [
        'amount' => '10.00',
        'currency' => 'USD'
    ],
    'pricing_type' => 'fixed_price',
    'metadata' => [
        'order_id' => '123456'
    ]
];

$charge = Charge::create($chargeData);
echo $charge->hosted_url; // URL na platobnú stránku

3. Získanie detailov platby

php

require 'vendor/autoload.php';

use CoinbaseCommerce\ApiClient;
use CoinbaseCommerce\Resources\Charge;

ApiClient::init($apiKey);

$chargeId = 'CHARGE_ID_HERE';
$charge = Charge::retrieve($chargeId);

print_r($charge);

Webhooky a spracovanie platby

Coinbase Commerce poskytuje webhooky, ktoré vám umožňujú prijímať notifikácie o zmene stavu platieb. Na implementáciu webhookov budete potrebovať nastaviť endpoint na vašom serveri.

1. Nastavenie webhook endpointu

php

// webhook.php
require 'vendor/autoload.php';

use CoinbaseCommerce\ApiClient;
use CoinbaseCommerce\Resources\Webhook;

ApiClient::init($apiKey);

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_CC_WEBHOOK_SIGNATURE'];

try {
    $webhook = Webhook::verify($payload, $signature);
    $event = $webhook->getEvent();

    // Spracovanie udalosti
    if ($event->type === 'charge:confirmed') {
        // Platba bola potvrdená
        $charge = $event->data;
        // Tu môžete implementovať ďalšie kroky, napr. aktualizovať databázu
    }
} catch (\Exception $e) {
    // Chyba pri overovaní
    http_response_code(400);
    echo 'Invalid webhook signature';
}

Bezpečnostné opatrenia

• Ochrana API kľúča: Uistite sa, že váš API kľúč je bezpečne uložený a nie je vystavený verejnosti.
• Overovanie webhookov: Vždy overujte podpisy webhookov, aby ste zabezpečili, že pochádzajú od Coinbase Commerce.

Záver

Integrácia Coinbase Commerce API do vašej PHP aplikácie môže výrazne zjednodušiť prijímanie kryptomenových platieb. Tento sprievodca vás mal naučiť základné operácie, ako aj bezpečnostné praktiky na ochranu vašich transakcií.