Ana içeriğe atla
PapelPay, PapelShip mağazanızın kartla ödeme yöntemidir. Store API ile sipariş oluşturur, siparişin PapelPay ödemesini başlatır ve müşterinin kartla ödemesini barındırılan ödeme sayfanızda ya da kendi sitenizdeki kart formunda alırsınız. Abonelik olarak satılan ürünlerin siparişlerinde kart her dönem yeniden çekilir.
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.