Widget Ödeme Hazırlama ve Tamamlama

8. Widget Ödeme Hazırlama (Prepare Payment)

Endpoint: POST /b2c/widget/preparePayment

Header

Alan	Tip	Zorunlu
Authorization	string	✔ (Bearer WidgetToken)

Request Body

card object

Alan	Tip	Zorunlu	Açıklama
cardNumber	string	✔	Kart numarası
cardHolderName	string	✔	Kart üzerindeki isim
cvv	string	✔	CVV
expMonth	int	✔	Son kullanma ay
expYear	int	✔	Son kullanma yıl

Root

Alan	Tip	Zorunlu	Açıklama
use3D	boolean	✔	3D Secure kullanımı
currency	string	✔	Para birimi
amount	decimal	✔	İşlem tutarı
installmentToken	string	✔	PaymentOptions’tan gelen token

Response

Alan	Tip	Açıklama
prepareToken	string	Ödeme işlemi için oluşturulan token

Request

{
 "card": {
   "cardNumber": "4155650100416111",
   "cardHolderName": "Test Test",
   "cvv": "000",
   "expMonth": 12,
   "expYear": 2030
 },
 "use3D": true,
 "currency": "TRY",
 "amount": 2750,
 "installmentToken": "INSTALLMENT_TOKEN"
}

9. Widget Ödeme Tamamlama

Endpoint: POST /b2c/widget/payment

Header

Alan	Tip	Zorunlu
Authorization	string	✔ (Bearer AccessToken)

Request Body

Alan	Tip	Zorunlu	Açıklama
amount	decimal	✔	İşlem tutarı
prepareToken	string	✔	PreparePayment sonucu
returnUrl	string	✔	3D sonrası dönüş URL
clientReferenceCode	string	✔	Merchant order id
customerIpAddress	string	✔	Kullanıcı IP

Response

Alan	Tip	Açıklama
paymentType	string	RedirectUrl / DirectSale
redirectTo	string	3D URL
orderId	string	Finrota işlem ID
clientReferenceCode	string	Merchant referansı
success	boolean	İşlem sonucu
error	string	Hata mesajı

3D Secure Akışı

Request

{
 "amount": 2750,
 "prepareToken": "PREPARE_TOKEN",
 "returnUrl": "https://merchant.com/callback",
 "clientReferenceCode": "ORDER123",
 "customerIpAddress": "1.1.1.1"
}

Response

{
 "paymentType": "RedirectUrl",
 "redirectTo": "3D_URL",
 "success": false
}

• Kullanıcı bu URL’e yönlendirilmelidir

3D'siz Akış

Response

{
 "paymentType": "DirectSale",
 "success": true
}