# Ödeme ## Ödeme Başlatma * API servisine gönderilmesi gereken parametreler * Örnek kodlar * API servisinden dönen parametreler ## Ödeme Servisi Parametreleri `POST` `https://api.weepay.co/Payment/PaymentRequest` Gönderilecek parametreler Auth, Data, Customer, BillingAddress, ShippingAddress, Products array'leri altında gönderilmelidir. dönen sonuç için **Response** tabı kontrol edilmelidir. Örnek **JSON** ve örnek gönderim için aşağıdaki örnek kodlar bölümünü inceleyebilirsiniz.
#### Path Parameters | Name | Type | Description | | --------- | ------- | ---------------------------------------------------------- | | Auth | array | Auth array altında bayiId, apiKey ve secretKey gönderilir. | | bayiId | integer | weepay tarafından verilen bayiId | | apiKey | string | weepay tarafından verilen apiKey | | secretKey | string | weepay tarafından verilen secretKey | #### Request Body | Name | Type | Description | | ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | Data | array | Data array altında gönderilecek parametreler | | orderId | string | Üye iş yeri sipariş id. | | ipAddress | string | Alıcıya ait ip adresi. | | paidPrice | number | Ödeme tutarı (Kuruş kısmı nokta ile yazılır. Örn: 35.50) | | currency | string | Para birimi TL, USD, EUR, GBP | | locale | string | Geri dönüş dili tr,en | | installmentNumber | integer | Taksit sayısı | | preAuth | integer | Ön provizyon işlemi için 1 gönderilmelidir | | cardHolderName | string | Kart sahibinin adı soyadı | | cardNumber | number | Kart numarası | | expireMonth | number | Kredi kartı son kullanım ay (ÖRN : 12) | | expireYear | number | Kredi kartı son kullanım yılı (ÖRN 2024 için 24) | | cvcNumber | number | Kredi Kartı güvenlik numarası | | description | string | Sipariş açıklaması | | Customer | string | Customer array altında gönderilecek parametreler | | customerId | string | Üye işyeri tarafındaki alıcıya ait id. | | customerName | string | Üye işyeri tarafındaki alıcıya ait ad. | | customerSurname | string | Üye işyeri tarafındaki alıcıya ait ad. | | gsmNumber | number | Üye işyeri tarafındaki alıcıya ait gsm no. | | email | string | Üye işyeri tarafındaki alıcıya ait email. | | identityNumber | number | Üye işyeri tarafındaki alıcıya ait kimlik (TCKN) numarası. | | city | string | Üye işyeri tarafındaki alıcıya ait şehir bilgisi. | | country | string | Üye işyeri tarafındaki alıcıya ait ülke bilgisi. | | BillingAddress | string | BillingAddress array altında gönderilecek parametreler | | contactName | string | Üye işyeri tarafındaki fatura adresi ad soyad bilgisi. | | address | string | Üye işyeri tarafındaki fatura adresi. | | city | string | Üye işyeri tarafındaki fatura adresi şehir bilgisi. | | country | string | Üye işyeri tarafındaki fatura adresi ülke bilgisi. | | district | string | Üye işyeri tarafındaki fatura adresi bölge bilgisi. | | zipCode | number | Üye işyeri tarafındaki fatura adresi posta kodu. | | ShippingAddress | string | ShippingAddress array altında gönderilecek parametreler | | contactName | string | Üye işyeri tarafındaki teslimat adresi, ad, soyad bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur. | | address | string | Üye işyeri tarafındaki teslimat adresi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur. | | city | string | Üye işyeri tarafındaki teslimat adresi şehir bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur. | | country | string | Üye işyeri tarafındaki teslimat adresi ülke bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur. | | district | string | Üye işyeri tarafındaki teslimat adresi bölge bilgisi. | | zipCode | number | Üye işyeri tarafındaki teslimat adresi posta kodu. | | Products | string | Products array altında gönderilecek parametreler | | productId | string | Üye işyeri tarafındaki sepetteki ürüne ait id. | | name | string | Üye işyeri tarafındaki sepetteki ürüne ait isim. | | productPrice | number | Üye işyeri tarafındaki sepetteki ürüne ait tutar. tutarlar toplamı sepet tutarına (paidPrice) eşit olmalıdır. | | itemType | string | Üye işyeri tarafındaki sepetteki ürüne ait tip. Geçerli enum değerler: PHYSICAL ve VIRTUAL. | {% tabs %} {% tab title="200 " %} ``` ``` {% endtab %} {% endtabs %} ## API servisi istek kodları Servis için örnek kodlar * PHP * .NET * Java * Ruby * Phython * Node.js {% tabs %} {% tab title="JSON" %} ```javascript // Request JSON example; { "Auth": { "bayiId":"22", "apiKey": "XXXXXXXXX", "secretKey": "XXXXXXXXXXXXXXXX" }, "Data":{ "orderId":1, "currency":"TL", "locale":"tr", "paidPrice":"0.16", "ipAddress":"192.168.1.1", "cardHolderName":"isim Soyisim", "cardNumber":"555522223333444", // Kart Numarası "expireMonth":"11", // Son Kullanım Ay "expireYear":"24", // Son Kullanım Yıl "cvcNumber":"556",// Kart CVC "installmentNumber":1, // Uygulanacak Taksit Sayısı "description":"Açıkalama"// Açıklama }, "Customer":{ "customerId":"1", // alıcı müşteri Id "customerName":"isim", //alıcı ismi "customerSurname":"soyisim", // alıcı Soyismi "gsmNumber":"50XXXXXXX",// alıcı cep telefonu "email":"hello@weepay.co", // alıcı mail "identityNumber":"112312312313132", // alıcı TC kimlik numarası "city":"istanbul",// alıcı şehir "country":"Turkey" // alıcı ülke }, "BillingAddress": { "contactName":"isim soyisim", "address":"Abdurrahman Nafiz Gürman,Mh, G. Ali Rıza Gürcan Cd. No:27", "city":"istanbul", "country":"turkey", "zipCode":34164 }, "ShippingAddress": { "contactName":"isim soyisim", "address":"Abdurrahman Nafiz Gürman,Mh, G. Ali Rıza Gürcan Cd. No:27", "city":"istanbul", "country":"turkey", "zipCode":34164 }, "Products": [ {"productId":"B104A", "name":"ürün bir","productPrice":2.3, "itemType":"PHYSICAL"}, {"productId":"C1087", "name":"ürün iki","productPrice":2.3, "itemType":"PHYSICAL" }, {"productId":"12233352", "name":"ürün üç","productPrice":2.3, "itemType":"PHYSICAL" } ] } ``` {% endtab %} {% tab title="PHP" %} ```php //https://github.com/weepay/weepay-php PHP lib. // composer or weepay initialize Bootstrap // Auth $options = new \weepay\Auth(); $options->setBayiID("xxxxxx");// weepay tarafıdan verilen bayiId $options->setApiKey("xxxx-xxxx-xxx");// weepay tarafıdan verilen apiKey $options->setSecretKey("xxxxxxx-xxxxxxxxx-xx-xx"); // weepay tarafıdan verilen secretKey $options->setBaseUrl("https://api.weepay.co"); //Request $request = new \weepay\Request\CreatePaymentRequest(); $request->setOrderId('1298'); $request->setIpAddress('192.168.2.1'); $request->setPrice(35.50); $request->setCurrency(\weepay\Model\Currency::TL); $request->setLocale(\weepay\Model\Locale::TR); $request->setDescription('Açıklama Alanı'); $request->setCardHolderName("isim soyisim"); $request->setCardNumber("555555555555555"); $request->setEpireMonth("01"); $request->setExpireYear("22"); $request->setCvcNumber("233"); $request->setInstallmentNumber(1); $request->setPaymentGroup(\weepay\Model\PaymentGroup::PRODUCT); $request->setPaymentChannel(\weepay\Model\PaymentChannel::WEB); //Customer $customer = new \weepay\Model\Customer(); $customer->setCustomerId(1235); // Üye işyeri müşteri Id $customer->setCustomerName("isim"); //Üye işyeri müşteri ismi $customer->setCustomerSurname("soyisim"); //Üye işyeri müşteri Soyisim $customer->setGsmNumber("50XXXXXX"); //Üye işyeri müşteri Cep Tel $customer->setEmail("helo@weepay.co"); //Üye işyeri müşteri ismi $customer->setIdentityNumber("00032222721"); //Üye işyeri müşteri TC numarası $customer->setCity("istanbul"); //Üye işyeri müşteri il $customer->setCountry("turkey");//Üye işyeri müşteri ülke $request->setCustomer($customer); //Adresler // Fatura Adresi $BillingAddress = new \weepay\Model\Address(); $BillingAddress->setContactName("isim soyisim"); $BillingAddress->setAddress("Abdurrahman Nafiz Gürman,Mh, G. Ali Rıza Gürcan Cd. No:27"); $BillingAddress->setCity("istanbul"); $BillingAddress->setCountry("turkey"); $BillingAddress->setZipCode("34164"); $request->setBillingAddress($BillingAddress); //Kargo / Teslimat Adresi $ShippingAddress = new \weepay\Model\Address(); $ShippingAddress->setContactName("isim soyisim"); $ShippingAddress->setAddress("Abdurrahman Nafiz Gürman,Mh, G. Ali Rıza Gürcan Cd. No:27"); $ShippingAddress->setCity("istanbul"); $ShippingAddress->setCountry("turkey"); $ShippingAddress->setZipCode("34164"); $request->setShippingAddress($ShippingAddress); // Sipariş Ürünleri $Products = array(); // Birinci Ürün $firstProducts = new \weepay\Model\Product(); $firstProducts->setName("Ürün Bir"); $firstProducts->setProductId(12344); $firstProducts->setProductPrice(0.10); $firstProducts->setItemType(\weepay\Model\ProductType::PHYSICAL); $Products[0] = $firstProducts; // İkinci Ürün $secondProducts = new \weepay\Model\Product(); $secondProducts->setName("Ürün İki"); $secondProducts->setProductId("C550A100"); $secondProducts->setProductPrice(0.10); $secondProducts->setItemType(\weepay\Model\ProductType::PHYSICAL); $Products[1] = $secondProducts; // Üçüncü Ürün $thirdProducts = new \weepay\Model\Product(); $thirdProducts->setName("Ürün Üç"); $thirdProducts->setProductId("1000"); $thirdProducts->setProductPrice("0.10"); $thirdProducts->setItemType(\weepay\Model\ProductType::PHYSICAL); $Products[2] = $thirdProducts; $request->setProducts($Products); $createPaymentRequest = \weepay\Model\CreatePaymentRequestInitialize::create($request, $options); echo "
";
print_r($createPaymentRequest);
echo "
"; ``` {% endtab %} {% tab title="Node" %} ```javascript // npm install weepay-nodejs or Add dependency 'weepay-nodejs' // in your package.json file // check sdk in samples folder CreatePaymentForm.js samples // Node.js v12.0.0 or later const weepay = require('weepay-nodejs'); weepay.configure({ bayiId: "bayi-id", apiKey: "apiKey", secretKey: "secretKey", baseUrl: "https://test-api.weepay.co" }); const request = { data: { orderId: 1, ipAddress: "192.168.2.1", paidPrice: 0.10, currency: Currency.TL, locale: Locale.TR, description: "Açıklama Alanı", cardHolderName: "isim soyisim", cardNumber: "555555555555555", expireMonth: "01", expireYear: "22", cvcNumber: "233", installmentNumber: 1, paymentGroup: PaymentGroup.PRODUCT, paymentChannel: PaymentChannel.WEB }, customer: { customerId: 1234, customerName: "isim", customerSurname: "soyisim", gsmNumber: "50XXXXXX", email: "helo@weepay.co", identityNumber: "00032222721", city: "istanbul", country: "turkey" }, billingAddress: { contactName: "isim soyisim", address: "Abdurrahman Nafiz Gürman,Mh, G. Ali Rıza Gürcan Cd. No:27", city: "istanbul", country: "turkey", zipCode: "34164" }, shippingAddress: { contactName: "isim soyisim", address: "Abdurrahman Nafiz Gürman,Mh, G. Ali Rıza Gürcan Cd. No:27", city: "istanbul", country: "turkey", zipCode: "34164" }, products: [ { name: "first product", productPrice: "30.00", itemType: ProductType.PHYSICAL, productId: "1234" }, { name: "first product", productPrice: "30.00", itemType: ProductType.PHYSICAL, productId: "1234" }, ] } weepay.createPayment(request).then(function (res) { if (res.status == "success") { console.log(res); } else { console.log(res.message) } }); ``` {% endtab %} {% tab title="Javascript" %} ```javascript // import weepay javascript library // check sample : https://github.com/weepay/weepay-javascript/blob/main/samples/createpayment.html var weepay = new weepayInit(); weepay.configure({ bayiId: "bayiId", apiKey: "apiKey", secretKey: "secretKey", baseUrl: "https://api.weepay.co" }) var request = { data: { orderId: 1, ipAddress: "192.168.2.1", paidPrice: 0.10, currency: Constants.Currency.TL, locale: Constants.Locale.TR, description: "Açıklama Alanı", cardHolderName: "isim soyisim", cardNumber: "555555555555555", expireMonth: "01", expireYear: "22", cvcNumber: "233", installmentNumber: 1, paymentGroup: Constants.PaymentGroup.PRODUCT, paymentChannel: Constants.PaymentChannel.WEB }, customer: { customerId: 1234, customerName: "isim", customerSurname: "soyisim", gsmNumber: "50XXXXXX", email: "helo@weepay.co", identityNumber: "00032222721", city: "istanbul", country: "turkey" }, billingAddress: { contactName: "isim soyisim", address: "Abdurrahman Nafiz Gürman,Mh, G. Ali Rıza Gürcan Cd. No:27", city: "istanbul", country: "turkey", zipCode: "34164" }, shippingAddress: { contactName: "isim soyisim", address: "Abdurrahman Nafiz Gürman,Mh, G. Ali Rıza Gürcan Cd. No:27", city: "istanbul", country: "turkey", zipCode: "34164" }, products: [ { name: "first product", productPrice: "30.00", itemType: Constants.ProductType.PHYSICAL, productId: "1234" }, { name: "first product", productPrice: "30.00", itemType: Constants.ProductType.PHYSICAL, productId: "1234" }, ] } weepay.createPayment(request, function (response) { if (response.status == "failure") { console.log(response.message); } else { console.log(response) } }); ``` {% endtab %} {% tab title="Java" %} ```java // https://github.com/weepay/weepay-java java SDK. // if you use maven, if not check github page others installation // // co.weepay // weepay-java // 1.0.0 // // check sdk in samples folder CreatePayment.txt samples // java 1.7 or later //Auth Auth options = new Auth(); options.setBayiId(bayiId); options.setApiKey("apiKey"); options.setSecretKey("secretKey"); options.setBaseUrl("https://api.weepay.co"); // Request CreatePaymentRequest request = new CreatePaymentRequest(); request.setOptions(options); request.setOrderId("1"); request.setIpAddress("192.168.1.2"); request.setPaidPrice(35.50); request.setCurrency(Currency.TL.name()); request.setDescription("Açıklama Alanı"); request.setCardHolderName("isim soyisim"); request.setCardNumber("555555555555555"); request.setexpireMonth("01"); request.setExpireYear("22"); request.setCvcNumber("223"); request.setInstallmentNumber(1); request.setPaymentGroup(PaymentGroup.PRODUCT.name()); request.setPaymentChannel(PaymentChannel.WEB.name()); // Customer Customer customer = new Customer(); customer.setCustomerId(1); customer.setCustomerName("isim"); customer.setCustomerSurname("soyisim"); customer.setGsmNumber("50XXXXXX"); customer.setEmail("hello@weepay.co"); customer.setIdentityNumber("00032222721"); customer.setCity("istanbul"); customer.setCountry("turkey"); request.setCustomer(customer); // Address // Billing Address Address billingAddress = new Address(); billingAddress.setContactName("isim soyisim"); billingAddress.setAddress("address"); billingAddress.setCity("city"); billingAddress.setCountry("turkey"); billingAddress.setZipCode("34164"); request.setBillingAddress(billingAddress); // Address // Shipping Address Address shippingAddress = new Address(); shippingAddress.setContactName("isim soyisim"); shippingAddress.setAddress("address"); shippingAddress.setCity("city"); shippingAddress.setCountry("turkey"); shippingAddress.setZipCode("34164"); request.setShippingAddress(shippingAddress); // Products // First Product List products = new ArrayList(); Product firstProduct = new Product(); firstProduct.setName("Ürün bir"); firstProduct.setProductId(1234); firstProduct.setProductPrice(0.10); firstProduct.setItemType(ProductType.PHYSICAL.name()); products.add(firstProduct); // Second Product Product secondProduct = new Product(); secondProduct.setName("Ürün iki"); secondProduct.setProductId(4567); secondProduct.setProductPrice(0.10); secondProduct.setItemType(ProductType.PHYSICAL.name()); products.add(secondProduct); request.setProducts(products); CreatePaymentInitialize payment = CreatePaymentInitialize.create(request, options); System.out.println(payment); ``` {% endtab %} {% tab title="Perl" %} ``` ``` {% endtab %} {% tab title="Ruby" %} ``` ``` {% endtab %} {% tab title="Phython" %} ``` ``` {% endtab %} {% tab title="Go" %} ``` ``` {% endtab %} {% tab title=".NET" %} ``` ``` {% endtab %} {% endtabs %} ## API servisinden dönen parametreler ### Başarılı Sonuç Örneği {% tabs %} {% tab title="Başarılı Sonuç" %} ```javascript { "status":"success", "paymentStatus":true, "paymentId":"", } ``` {% endtab %} {% endtabs %} ### Başarısız Sonuç Örneği {% tabs %} {% tab title="Başarısız Sonuç" %} ```javascript { "status":"failure", "errorCode":"xxxxx", "message":true, "paymentStatus":false, } ``` {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developer.weepay.co/api/odeme-servisi-kendi-formunuz/odeme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.