Kredi Kartı Güncelleme

Mevcut kredi kartı yerine, yeni bir kredi kartı eklemek için kullanılacak servistir.
POST   https://api.zotlo.com/v1/payment/change-card
Bu servis ile kullanıcının kredi kartından bir ücret çekilmez. Sadece kart bilgileri güncellenerek yenileme periyotlarının yeni kredi kartından yapılması sağlanır.
Ödeme servisi için gönderilmesi gereken parametreler şunlardır :
Alan
Açıklama
cardNo
Kredi kartı numarası. Geçerli formatta gönderilmelidir.
cardOwner
Kredi kartının sahibinin adı.
expireMonth
Kredi kartı son kullanma tarihi ayı. 2 karakter olarak gönderilmelidir.
expireYear
Kredi kartı son kullanma tarihi yılı. 2 karakter olarak gönderilmelidir.
cvv
Kredi kartı güvenlik kodu
subscriberId
Kart bilgilerinin güncelleneceği abonenin id'sidir. Sadece aktif aboneler kart bilgilerini güncelleyebilir.
redirectUrl
Eğer provider 3D Secure üzerinden işlem gerçekleştirirse işlem sonucunda dönülecek adrestir.
Kart Bilgilerini Güncellemek İçin Örnek İstek
Curl
Php
Swift
Java
Python
C#
curl --location --request POST 'https://api.zotlo.com/v1/subscription/change-card' \
--header 'AccessKey: ***' \
--header 'AccessSecret: ***' \
--header 'Content-Type: application/json' \
--header 'ApplicationId: 6' \
--header 'Language: tr' \
--data-raw '{
	"cardNo":"4111111111111111",
	"cardOwner":"Test Test",
	"expireMonth":"12",
	"expireYear":"20",
	"cvv":"123",
	"subscriberId":"7",
	"redirectUrl":"https:/www.example.com/callback/save-card"
}'
$curl = curl_init();
​
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.zotlo.com/v1/subscription/change-card",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS =>"{\n\t\"cardNo\":\"4111111111111111\",\n\t\"cardOwner\":\"Test Test\",\n\t\"expireMonth\":\"12\",\n\t\"expireYear\":\"20\",\n\t\"cvv\":\"123\",\n\t\"subscriberId\":\"7\",\n\t\"redirectUrl\":\"https:/www.example.com/callback/save-card\"\n}",
  CURLOPT_HTTPHEADER => array(
    "AccessKey: ***",
    "AccessSecret: ***",
    "Content-Type: application/json",
    "ApplicationId: 6",
    "Language: tr"
  ),
));
​
$response = curl_exec($curl);
​
curl_close($curl);
echo $response;
import Foundation
​
var semaphore = DispatchSemaphore (value: 0)
​
let parameters = "{\n\t\"cardNo\":\"4111111111111111\",\n\t\"cardOwner\":\"Test Test\",\n\t\"expireMonth\":\"12\",\n\t\"expireYear\":\"20\",\n\t\"cvv\":\"123\",\n\t\"subscriberId\":\"7\",\n\t\"redirectUrl\":\"https:/www.example.com/callback/save-card\"\n}"
let postData = parameters.data(using: .utf8)
​
var request = URLRequest(url: URL(string: "https://api.zotlo.com/v1/subscription/change-card")!,timeoutInterval: Double.infinity)
request.addValue("***", forHTTPHeaderField: "AccessKey")
request.addValue("***", forHTTPHeaderField: "AccessSecret")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("6", forHTTPHeaderField: "ApplicationId")
request.addValue("tr", forHTTPHeaderField: "Language")
​
request.httpMethod = "POST"
request.httpBody = postData
​
let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
}
​
task.resume()
semaphore.wait()
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n\t\"cardNo\":\"4111111111111111\",\n\t\"cardOwner\":\"Test Test\",\n\t\"expireMonth\":\"12\",\n\t\"expireYear\":\"20\",\n\t\"cvv\":\"123\",\n\t\"subscriberId\":\"7\",\n\t\"redirectUrl\":\"https:/www.example.com/callback/save-card\"\n}");
Request request = new Request.Builder()
  .url("https://api.zotlo.com/v1/subscription/change-card")
  .method("POST", body)
  .addHeader("AccessKey", "***")
  .addHeader("AccessSecret", "***")
  .addHeader("Content-Type", "application/json")
  .addHeader("ApplicationId", "6")
  .addHeader("Language", "tr")
  .build();
Response response = client.newCall(request).execute();
import requests
​
url = "https://api.zotlo.com/v1/subscription/change-card"
​
payload = "{\n\t\"cardNo\":\"4111111111111111\",\n\t\"cardOwner\":\"Test Test\",\n\t\"expireMonth\":\"12\",\n\t\"expireYear\":\"20\",\n\t\"cvv\":\"123\",\n\t\"subscriberId\":\"7\",\n\t\"redirectUrl\":\"https:/www.example.com/callback/save-card\"\n}"
headers = {
  'AccessKey': '***',
  'AccessSecret': '***',
  'Content-Type': 'application/json',
  'ApplicationId': '6',
  'Language': 'tr'
}
​
response = requests.request("POST", url, headers=headers, data = payload)
​
print(response.text.encode('utf8'))
var client = new RestClient("https://api.zotlo.com/v1/subscription/change-card");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("AccessKey", "***");
request.AddHeader("AccessSecret", "***");
request.AddHeader("Content-Type", "application/json");
request.AddHeader("ApplicationId", "6");
request.AddHeader("Language", "tr");
request.AddParameter("application/json", "{\n\t\"cardNo\":\"4111111111111111\",\n\t\"cardOwner\":\"Test Test\",\n\t\"expireMonth\":\"12\",\n\t\"expireYear\":\"20\",\n\t\"cvv\":\"123\",\n\t\"subscriberId\":\"7\",\n\t\"redirectUrl\":\"https:/www.example.com/callback/save-card\"\n}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Kart Güncelleme İşlemi Başarılı İse
{
    "meta": {
        "requestId": "6d2989e84793-REQ-5f32ae118251c",
        "httpStatus": 200
    },
    "result": {
        "response": {
            "isSuccess": true,
            "transactionId": "92cf3a1e-cf55-4593-990b-48e4b632b8fb",
            "providerTransactionId": "66ab6034-2bd8-49f1-8779-997606c87537",
            "customTransactionId": "5f32ae11c786c",
            "statusCode": "S0000001",
            "statusMessage": "Ödeme işlemi başarıyla tamamlandı.",
            "paymentDate": "2020-08-11 02:41:23",
            "providerStatus": null,
            "paymentStatus": "COMPLETE",
            "redirectUrl": null,
            "paymentProvider": "Zotlopay"
        }
    }
}
Hata Durumları
Ödeme servislerinden HTTP status code olarak başarılı durumlarda 200 dönmektedir. Başarısız durumlarda ise 400 ya da 500 Http StatusCode dönmektedir. Örnek hata cevabı aşağıdaki şekildedir.
{
    "meta": {
        "requestId": "MacBook-Pro.local-REQ-5e7ce1aa1eb10",
        "httpStatus": 400,
        "errorMessage": "Abonelik oluşturmaya çalıştığınız kullanıcıya ait aktif bir abonelik bulunmaktadır.",
        "errorCode": 400007
    },
    "result": []
}
Cevap
Açıklama
requestId
Her istek için sistem tarafından atanan id değeridir. Sistemsel hatalarda log'lardan hata yakalamak için kullanılır.
httpStatus
Hatanın HTTP durum kodu değeri
errorMessage
Hata mesajı. Tüm hata kodlarına "Hata Kodları" menüsünden ulaşabilirsiniz.
errorCode
İlgili hata için Zotlo tarafından verilen hata kodu

Abonelik Servisleri - Previous

Abone Paket Değişimi

Next - Abonelik Servisleri

Kullanıcı Sayısı Güncelleme

Last modified 11mo ago

Copy link

Outline

Kart Bilgilerini Güncellemek İçin Örnek İstek

Kart Güncelleme İşlemi Başarılı İse

Hata Durumları