Rehberler

WooCommerce

WooCommerce için ödeme yöntemi: bitcoin ve USDC/USDT doğrudan senin cüzdanına, siparişi imzalı bir webhook ödendi olarak işaretler.

Markdown olarak aç

Perly Pay eklentisi klasik ödeme ekranına ve Checkout bloğuna kripto ekler. Her sipariş bir Perly Pay faturası olur; alıcı onu mağazanın üstünde ya da ayrı bir sayfada öder; imzalı bir webhook siparişi ödendi olarak işaretler. WordPress 6.5+, WooCommerce 8.6+, PHP 8.1+. Sunucuya kurulacak bir şey yok: PHP SDK zaten içinde.

Faturalar USD ya da EUR olarak kesilir. Başka para birimli bir mağazada ödeme yöntemi gizlenir ve ayarları nedenini açıklar.

Kurulum

1
Zip'i al
Eklenti WordPress.org'a yolda. Orada olana kadar perly-pay-woocommerce.zip için bize yaz.
2
Kur
WordPress'te: Eklentiler → Yeni ekle → Eklenti yükle, zip'i seç, etkinleştir. WooCommerce etkin olmalı.
3
Ayarları aç
WooCommerce → Ayarlar → Ödemeler → Perly Pay.

Ayarlar

Alan	Ne yazılır
Gizli anahtar	Dashboard → Developers → API keys. Test modu için `sk_test_…`, gerçek para için `sk_live_…`. Ayarlar hangi modda olduğunu gösterir.
Webhook imza secret'ı	`whsec_…`. Webhook'u ayarla onu kendisi doldurur.
Ödeme sayfası	Pencere ödemeyi mağazanın üstünde açar (pay.js). Yönlendirme alıcıyı ödeme sayfasına götürür. Telefonlarda her zaman sayfanın kendisi açılır.
Ödemeden sonraki durum	WooCommerce'in karar verdiği gibi (İşleniyor; indirmeler için Tamamlandı), her zaman İşleniyor ya da her zaman Tamamlandı.
Başlık, Açıklama	Alıcıların ödeme sırasında gördüğü.
Hata ayıklama günlüğü	WooCommerce → Durum → Günlükler'de olaylar ve hatalar. Asla anahtarlar, secret'lar ya da alıcı verileri değil.

1
Anahtarı yapıştır
Ve Bağlantıyı test et'e bas: anahtarın çalışıp çalışmadığını, modunu ve bu mağazanın webhook'unun Perly Pay'de olup olmadığını görürsün.
2
Webhook'u ayarla
Webhook'u ayarla'ya bas. Mağazanın adresini (butonların üstünde, …/wp-json/perly-pay/v1/webhook) Perly Pay'e ekler ve secret'ı kaydeder. Ya da adresi kendin Developers → Webhooks'ta ekle ve secret'ı yapıştır.
3
Pencereye izin ver
Dashboard → Settings'te mağaza adresini Sites that may embed the checkout listesine ekle. Bu olmadan pencere ödemeyi yeni sekmede açmayı önerir.
4
Aç
Perly Pay ile kripto kabul et'i işaretle ve kaydet.

Test

sk_test_… anahtarıyla kendi mağazanda sipariş ver ve Perly Pay'i seç. Sipariş Ödeme bekleniyor durumunda bekler. Faturayı test coinleriyle ya da API üzerinden öde — kimliği sipariş notlarında yazar:

bash

curl -X POST https://pay.perly.io/api/v1/invoices/inv_…/simulate \
  -H "Authorization: Bearer $PERLY_PAY_SECRET_KEY" -H "Content-Type: application/json" -d '{}'

Birkaç saniye içinde sipariş, bir notla birlikte İşleniyor olur: ağ, tutar ve işlem bağlantısı. Fatura sayfasında coin zaten seçiliyse {"outcome":"short"} ve {"outcome":"over"} diğer durumları test eder.

Siparişler ödemeleri nasıl izler

Perly Pay'de	Sipariş
Ödendi, gönderen kontrol edildi (`invoice.fulfilled`)	Ödendi: seçilen durum, stok düşüldü, alıcıya e-posta. Her transfer ve işlemiyle bir not.
Görüldü, kısmen ödendi, ödendi ve hâlâ kontrol ediliyor	Bir not. Beklemeye devam eder.
Kontrol için bekletildi	Beklemede, nedeniyle. Perly Pay'de karar ver.
Süresi doldu ya da iptal edildi, hiçbir şey ödenmedi	İptal edildi.
Süresi doldu, kısmen ödendi	Beklemede: Perly Pay'de iade et ya da kabul et.
İade edildi	Tamamen iade edildi ya da kısmi iade notu.

Her olay bir kez, oluşturulduğu siparişe uygulanır; geç gelen bir "süresi doldu" ödemeyi asla iptal etmez. Alıcı teşekkür sayfasına webhook'tan önce dönerse eklenti API'ye sorar ve siparişi hemen günceller.

İadeler

Sipariş sayfasından her zamanki gibi iade et: eklenti Perly Pay'de ödenen coinle bir iade açar (kısmi iadede o kısmı). Perly Pay alıcıdan e-postayla adres ister ve kontrol eder; sipariş notları neyin nereye gönderileceğini söyler. Sen kendi cüzdanından gönderirsin ve işlem kimliğini Perly Pay'e yapıştırırsın — Perly Pay parayı asla tutmaz.

Canlıya geçiş

Perly Pay'de canlı modu aç ve cüzdanın açık anahtarlarını bağla.
sk_live_… anahtarını yapıştır. Canlı anahtarlar ve webhook'lar testtekilerden ayrıdır: Webhook'u ayarla'ya bir kez daha bas.
Canlı modda canlı mağazanın https adresini Sites that may embed the checkout listesine ekle.
Küçük, gerçek bir sipariş ver ve iade et.