Uç noktalara genel bakış
| Uç nokta | Kimlik doğrulama | Amaç |
|---|---|---|
POST /v1/payments | gizli anahtar | Kart veya cüzdan ödemesi oluşturma |
POST /v1/pay | — | Hesapsız ödeme oluşturma (ödeme cüzdanıyla) |
POST /v1/crypto/payments | gizli anahtar | Kripto ödeme oluşturma |
POST /v1/crypto/pay | — | Hesapsız kripto ödeme |
GET /v1/payments/:id | gizli anahtar | Ödeme durumu |
GET /v1/payments | gizli anahtar | Ödeme listesi |
GET /v1/providers | — | Bir tutar ve para birimi için kullanılabilir ödeme yöntemleri |
GET /v1/crypto/coins | — | Kripto altyapısının coin’leri, ağları ve minimumları |
GET /v1/currencies | — | Kabul edilen itibari para birimleri |
Tüm alanlar, hatalar ve örneklerle tam referans: API dokümantasyonu.
Ödeme oluşturma
Tutarı ve para birimini gönderin; isterseniz provider ile bir yöntem sabitleyin (örneğin kart ve Apple Pay için stripe, paypal, revolut veya UPI için transak). Alıcıyı checkout_url adresine yönlendirin.
curl -X POST https://api.utopay.app/v1/payments \
-H "Authorization: Bearer utopay_sk_live_..." \
-H "content-type: application/json" \
-d '{ "amount": 49.90, "currency": "EUR", "description": "Order #1042",
"success_url": "https://shop.example/thanks" }'
# → { "id": "ord_…", "status": "pending",
# "checkout_url": "https://api.utopay.app/pay/ord_…" }
Webhook’larla onaylama
Panelde bir uç nokta kaydedin. UTOPAY, x-utopay-signature başlığıyla (zaman damgası ve ham gövde üzerinde HMAC-SHA256) payment.succeeded, payment.underpaid, payment.expired ve payment.failed gönderir. Yeniden denemeler yaklaşık yedi saat sürer. Node.js, PHP ve Python doğrulama örnekleri webhook dokümanlarında.
Kodsuz ve az kodlu seçenekler
- Ödeme linkleri: panelde bir link oluşturup paylaşın, hiç kod gerekmez. Bkz. ödeme linkleri.
- CMS eklentileri: WooCommerce, WHMCS, OpenCart, PrestaShop, MODX, Easy Digital Downloads, Paid Memberships Pro ve Tilda. Bkz. eklentiler.
- Test modu: test anahtarları gerçek para olmadan sipariş oluşturur, durumları panelden simüle edebilirsiniz.
Güncellendi · UTOPAY ekibi