Site ou application connecté

Intégration Web

Utilisez le SDK serveur @swimpay/node pour créer les commandes et vérifier les événements.

npm install @swimpay/node

import { SwimPay } from "@swimpay/node";

const swimpay = new SwimPay({
  secretKey: process.env.SWIMPAY_SECRET_KEY!,
  apiBaseUrl: process.env.SWIMPAY_API_BASE_URL
});

const checkout = await swimpay.orders.create({
  externalOrderId: order.id,
  amountMinor: order.amountMinor,
  currency: "RUB",
  returnUrl: "https://merchant.example/orders/" + order.id
}, {
  idempotencyKey: order.id
});

return checkout.checkoutUrl;

const event = swimpay.webhooks.verify(
  req.body,
  req.headers,
  process.env.SWIMPAY_WEBHOOK_SECRET!
);

switch (event.type) {
  case "payment.confirmed":
    // Fulfill after merchant manual confirmation.
    break;
  case "payment.rejected":
  case "payment.expired":
    break;
}

// Browser/frontend: redirect only.
window.location.href = checkout.checkoutUrl;

Intégration Android

Application Android → votre backend → SwimPay → checkout_url → retour app → votre backend vérifie le statut

AVotre application Android ne doit jamais contenir la clé secrète SwimPay.

Après le retour, rafraîchissez le statut depuis votre backend.

val checkoutUrl = merchantBackend.createSwimPayCheckout(orderId)

SwimPayCheckout.open(
  activity = this,
  checkoutUrl = checkoutUrl
)

override fun onNewIntent(intent: Intent) {
  super.onNewIntent(intent)
  val result = SwimPayCheckout.parseReturnIntent(intent)
  if (result != null) {
    // Ne validez pas localement.
    refreshOrderStatusFromBackend()
  }
}