Edit this page

Kutu Abonelik Kurgusu

subscrEASY'yi detaylı olarak incelemeden önce, basit bir örnekle uygulamanın nasıl çalıştığı hakkında fikir sahibi olalım. Örnek olarak, Kutu abonelik servisi için, sistemi konfigüre edelim.

  1. Offer tanımlama
  2. Start Subscription servisini kullanarak yeni bir abonelik oluşturulması.

Offer Tanımlama

  • Abonelik Sihirbazı yönetim paneline giriş yapılır.
  • Offer bağlantısına tıklanır.
  • Örnek bir offer tanımı yapacağız. "Create Offer" butonuna tıklayalım.
  • Bu örnekte kutu aboneliği satıyor olalım. Satışa çıkaracağımız paketimizin adı "Sürpiz Kutu Abonelik", fiyatı 79 TL, abonelik süresi 12 ay olsun. Formu aşağıdaki değerleri kullanarak dolduralım ve Save butonuna basalım.

Paket adı: Sürpiz Kutu Abonelik
Fiyatı: 79 TL Süre: 12 ay

  • Paket tanımı tamamlandı. Aşağıdaki ekran görüntüsünde işaretlenen secureId ile ilk abonelik işlemini Start Subscription servisini kullanarak gerçekleştireceğiz.
  • Abonelik gerçekleştirmek için Start Subscription servisini kullanacağız. Aboneliği test kullanıcımız olan John beye satıyoruz. Kredi kart bilgileri olarak bir test kartının bilgilerini kullanıyoruz. Curl komutunda görüldüğü gibi, işlemi gerçekleştirmek için Apikey değerini girmeyi unutmayınız. Apikey bilgisini yönetim panelinin Company Profile bölümünden ulaşabilirsiniz.
Request:
{
    "offer": {"secureId":"8a05de93-4df4-4a97-b1f2-6f19c0857cf"},
    "subscriber": {
        "secureId": "26b74071-ca3e-4854-9bd9-c166270f8697",
        "email": "johndoe@gmail.com"
    },
    "paymentCard": {
        "cardHolderName": "John Doe",
        "cardNumber": "5528790000000008",
        "expireYear": "2030",
        "expireMonth": "12",
        "cvc": "123",
        "registerCard": 0
    }
}
Response:
{
  "subscription": {
    "id": 2,
    "subscriberId": "8a05de93-4df4-4a97-b1f2-6f19c0857cff",
    "status": "ACTIVE",
    "startDate": "2018-02-20T14:47:53.194+03:00",
    "endDate": "2018-02-20T14:50:53.194+03:00",
    "card": {
      "id": 1,
      "cardAlias": "Halk Bankası",
      "cardUserKey": "SSd64vcBmW1z3bPuHBQc6EpD7Ec=",
      "cardToken": "FGexivhyvLAM93t2uetTNm8kA+w=",
      "binNumber": "552879",
      "cartType": "CREDIT_CARD",
      "cardAssociation": "MASTER_CARD",
      "cardFamily": "Paraf",
      "cardBankCode": 12,
      "cardBankName": "Halk Bankası"
    },
    "version": 1,
    "services": []
  },
  "payment": {
    "id": 2,
    "price": 0.99,
    "appliedCoupon": null,
    "paymentId": "10706704",
    "authCode": "301010",
    "errorCode": null,
    "errorText": null,
    "jobId": null,
    "invoiceId": null,
    "subscriptionId": 2,
    "serviceInstanceId": null,
    "subscriberSecureId": "8a05de93-4df4-4a97-b1f2-6f19c0857cff",
    "companyId": -1,
    "paymentGateway": "IYZICO",
    "chargingStatus": "CHARGED",
    "reason": "START",
    "createDate": "2018-02-20T14:47:56.228+03:00"
  }
}
curl -X POST \
  https://sandbox.subscreasy.com/api/subscriptions/start \
  -H 'accept: application/json' \
  -H 'authorization: Apikey brs-1234567890' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
    "offer": {"secureId":"8a05de93-4df4-4a97-b1f2-6f19c0857cf"},
    "subscriber": {
        "secureId": "26b74071-ca3e-4854-9bd9-c166270f8697",
        "email": "johndoe@gmail.com"
    },
    "paymentCard": {
        "cardHolderName": "John Doe",
        "cardNumber": "5528790000000008",
        "expireYear": "2030",
        "expireMonth": "12",
        "cvc": "123",
        "registerCard": 0
    }
}'
  • JSON örneğinde servis sonucuna yer verilmiştir. Servis sonucunda aboneliğin 20.02.2018'de başladığını ve 20.02.2019'a kadar devam edeceğini görüyoruz.