Home

Sepet bilgisinin Ödeal tarafından, sunucunuzdan alınacağı servistir. external-basket-with-app ya da external-basket-with-ecommerce-url profilleri kullanıldığı durumda sepet bilgisinin oluşturulması ve Ödeal tarafından kullanılabilir olması gerekmektedir. Bu tanımları konfigürasyon tanımlama adımında tanımlanmaktadır. Buradan ulaşabilirsiniz.

App-to-App bir sepet bilgisi iletimi olacak ise (external-basket-with-app), kendi uygulamanızda android ya da kotlin kod örneklerinde olduğu gibi Ödeal mobil uygulamasını sadece sepete ait tekil referans kodu ile açmanız yeterli olacaktır.

İlgili profilller için sepetin alınacağı url bilgisini, basketUrl olarak tanımlamanız gerekmektedir. Ürün birim kodları için Odeal ile iletişime geçiniz.


Mobil uygulamanızdan Ödeal uygulamasını uyandırıp ödeme tamamlandıktan sonra ödeme sonucunun tekrar mobil uygulamanıza gönderilmesi.

1 - Ödeal uygulamasının sepet referans koduyla uyandırılması

Android uygulamasından Ödeal uygulamasına veri göndermek için intent kullanabilirsiniz. Bu işlem için aşağıdaki adımları takip edebilirsiniz:


{
      String referenceCode = "tekil-basket-referans-kodu";
      Uri uri = Uri.parse("https://basket.ode.al/" + referenceCode);
      Intent intent = new Intent(Intent.ACTION_VIEW, uri);
      startActivity(intent);
}
{
      val referenceCode = "tekil-basket-referans-kodu"
      val uri = Uri.parse("https://basket.ode.al/${referenceCode}")
      val intent = Intent(Intent.ACTION_VIEW, uri)
      startActivity(intent)
}

2 - Ödeal'a iletilen sepet referans kodu ile sepet detayının alınması

Konfigürasyon adımında API aracılığıyla bir basket_url kaydetmeniz gerekmektedir.
Sonrasında ödeala iletilen {tekil basket referans kodu} ile basket_url adresinizden sepet detayı çekilecektir. Burada basket_url adresinizde aşağıdaki gibi bir response modeli dönüşü beklenmektedir.

PATH PARAMETERS
referenceCodestring
HEADER PARAMETERS
X-ODEAL-REQUEST-KEYstring
requiredÖdeal tarafından atılacak istekler (basket bilgisi alma, müşteri sorgulama vb.)
için kullanılacak anahtardır. Zorunlu alandır.

Response :


{
      "referenceCode": 0,
      "receiptInfo": {
                "key1": "value1",
                "key2": "value2"
            },
      "customInfo": "string",
      "employeeInfo": {
                "employeeReferenceCode": "string",
                "name": "string",
                "surname": "string",
                "gsmNumber": "string",
                "identityNumber": "string",
                "mailAddress": "string"
            },
      "customerInfo": {
                "referenceCode": "string",
                "type": "INDIVIDUAL",
                "name": "string",
                "surname": "string",
                "identityNumber": "string",
                "gsmNumber": "2121234567",
                "email": "string",
                "city": "string",
                "town": "string",
                "address": "string"
            },
      "basketPrice": {
                "grossPrice": 0.1
            },
      "products": [  
                { }  
            ],
      "paymentOptions": [  
                { }  
            ]
      }
]