Mağazanızda PapelPay’in açık olması gerekir. Panelde PapelPay bölümünden başvurun; mağazanız onaylanana kadar bu sayfadaki uçlar
PAPELPAY_NOT_ENABLED döner.Kart ödemesi nasıl işler
1
Siparişi oluşturun
Sipariş oluşturma ve yönetme sayfasındaki gibi müşteri ve ürünlerle
POST /api/v1/invoices çağırın. Abonelik ürününü abonelik ya da tek seferlik satmak için auto_renew ekleyin. Bkz. Abonelikler.2
Kart ödemesini başlatın
POST /api/v1/invoices/{invoiceId}/papelpay çağırın ya da siparişi oluştururken "payment_method": "PAPELPAY" gönderip ikisini tek çağrıda yapın. Cevapta bir payment nesnesi gelir.3
Müşterinin ödemesini alın
Müşteriyi
payment.payment_url adresine, yani kart formuyla açılan ödeme sayfanıza gönderin. Müşteriyi kendi sitenizde tutmak için payment.embed_url adresini JavaScript SDK ile yerleştirin. Bkz. Sitenizde kart formu.4
Siparişi doğrulayın
Kart çekildiğinde sipariş
completed olur ve PapelShip ürünleri teslim eder. order.completed webhook’unu dinleyin ya da siparişi GET /api/v1/invoices/{invoiceId} ile okuyun. Bkz. Webhook’lar.Kart ödemesini başlatın
Cevap (200)
Ödeme açıkken uç tekrar çağrılırsa aynı
session_id döner. Idempotency-Key içinde sipariş kimliğini kullanın.
payment nesnesi
Hatalar
Sipariş oluştururken
"payment_method": "PAPELPAY" gönderdiyseniz ve kart ödemesi başlatılamadıysa sipariş yine de oluşur. Hatanın details.invoice_id alanı siparişi gösterir; POST /invoices/{invoiceId}/papelpay ile tekrar deneyebilirsiniz.
Sonraki adımlar
Abonelikler
Bir ürünü abonelik olarak satın ve yenilemelerini takip edin.
Sitenizde kart formu
Kart formunu kendi ödeme sayfanızda gösterin.