Integracja — Payment Gateway

Quick start

Cztery kroki do pierwszej transakcji

1

Załóż konto testowe

60 sekund, bez karty kredytowej. Automatyczne klucze sandbox.

2

Wywołaj POST /v1/payments

Jeden request, jedna odpowiedź. Idempotencja po `Idempotency-Key`.

3

Przekieruj na 3DS (jeśli trzeba)

Response zawiera `requires_action` + URL. Po challenge webhook wraca do Ciebie.

4

Odbierz webhook

Signed HMAC, retry z DLQ. Przełącz się na produkcję zamieniając klucz API.

Kod

Pięć SDK, jedno API

Ten sam endpoint, takie same typy odpowiedzi. Wybierz ulubiony język.

import { PaymentGateway } from "@payment-orchestrator/sdk";

const gw = new PaymentGateway({ apiKey: process.env.PAYORCH_KEY });

const payment = await gw.payments.create({
  amount: 19900,
  currency: "PLN",
  method: "card",
  reference: order.id,
  idempotencyKey: order.checkoutId,
  threeDSecure: { version: "2", challenge: "adaptive" },
});

from payment_orchestrator import PaymentGateway

gw = PaymentGateway(api_key=os.environ["PAYORCH_KEY"])

payment = gw.payments.create(
  amount=19900,
  currency="PLN",
  method="card",
  reference=order.id,
  idempotency_key=order.checkout_id,
  three_d_secure={"version": "2"},
)

use PaymentOrchestrator\Client;

$gw = new Client(['api_key' => getenv('PAYORCH_KEY')]);

$payment = $gw->payments->create([
  'amount'     => 19900,
  'currency'   => 'PLN',
  'method'     => 'card',
  'reference'  => $order->id,
]);

import "github.com/payment-orchestrator/go-sdk"

gw := paymentorchestrator.New(os.Getenv("PAYORCH_KEY"))

payment, err := gw.Payments.Create(ctx, &paymentorchestrator.PaymentParams{
  Amount:    19900,
  Currency:  "PLN",
  Method:    "card",
  Reference: order.ID,
})

curl -X POST https://api.payment-orchestrator.eu/v1/payments \
  -H "Authorization: Bearer $PAYORCH_KEY" \
  -H "Idempotency-Key: chk_9a12f" \
  -d '{
    "amount": 19900,
    "currency": "PLN",
    "method": "card",
    "three_d_secure": { "version": "2" }
  }'

SDK

Oficjalne biblioteki

Pełne typy, testy, przykłady. Otwarte źródło na GitHubie.

Node.js / TypeScript

npm i @payment-orchestrator/sdk

v2.4.1

Python

pip install payment-orchestrator

v2.1.0

PHP

composer require payment-orchestrator/sdk

v1.9.3

Go

go get github.com/payment-orchestrator/go-sdk

v1.6.0

Ruby

gem install payment_orchestrator

v1.2.4

.NET / C#

dotnet add package PaymentOrchestrator

v1.0.0

Webhooks

Zdarzenia, na które nasłuchujesz

HMAC-SHA256 sygnowane, exponential backoff, replay z panelu.

payment.authorizedAutoryzacja udana, środki zablokowane

payment.capturedCapture wykonany, transakcja finalna

payment.failedAutoryzacja odrzucona przez wydawcę

payment.refundedPełny lub częściowy zwrot

payment.requires_actionChallenge 3DS2 wymagany

dispute.openedChargeback od banku wydającego

dispute.won / dispute.lostRozstrzygnięcie sporu

payout.settledRozliczenie na konto bankowe

Platformy

Gotowe wtyczki e-commerce

Zero kodu — zainstaluj, wklej klucz, przyjmuj płatności.

WooCommerce

Shopify

PrestaShop

Magento 2

Sylius

Od curl do produkcji
w jedno popołudnie