Ödeme Alma Servisi

Ödeme Alma Servisi

Metod	API URL	Parametreler
POST	https://base-url/api/pay/RecurringPayment	JSON File

Servise gönderilmesi gereken parametreler şu şekildedir;

Ödeme Alma Servisi İstek Mesajı Parametreleri

Parametre	Tip	Zorunlu	Açıklama
MERCHANT	string	Evet	Üye iş yerine özel oluşturulan eşsiz kimlik bilgisidir.
MERCHANT_KEY	string	Evet	Üye iş yerine özel oluşturulan anahtar bilgisidir.
BACK_URL	string	Evet	İşlem sonuç cevabının sistem tarafından döndürüleceği adres bilgisidir. İşlem cevabı üye iş yeri tarafından bu adresten okunacaktır. İşlem sonucu JSON formatında POST edilerek gönderilir.
PRICES_CURRENCY	string	Evet	Ödeme işleminin gerçekleştirileceği para birimi bilgisidir. Şu an için sadece “TRY, USD, EUR, GBP” gönderilebilir.
ORDER_REF_NUMBER	string	Evet	Üye iş yeri tarafından verilecek referans numarası bilgisidir. Ödeme işlemleri bu referans numarası ile takip edilebilir. Maksimum 24 karakter kullanılabilir.
ORDER_AMOUNT	string	Evet	Ödeme işlemine ait işlem tutarı bilgisidir.
REPEAT	int	Evet	Tekrar sayısı.
TRIES_COUNT	string	Evet	Tekrarı deneme sayısı.
START_DATE	string	Evet	Tekrarlı ödemenin başlangıç tarihi

CARDS

Parametre	Tip	Zorunlu	Açıklama
CC_NUMBER	string	Evet	Ödeme işleminin gerçekleştirileceği karta ait 16 haneli kart numarası bilgisidir.
EXP_MONTH	string	Evet	Ödeme işleminin gerçekleştirileceği karta ait 2 haneli son kullanım tarihini ay bilgisidir.
EXP_YEAR	string	Evet	Ödeme işleminin gerçekleştirileceği karta ait 4 haneli son kullanım tarihini yıl bilgisidir.
CC_CVV	string	Evet	Ödeme işleminin gerçekleştirileceği kartın arka yüzünde bulunan 3 haneli güvenlik kodu bilgisidir.
CC_OWNER	string	Evet	Ödeme işleminin gerçekleştirileceği kart sahibinin ad ve soyadı bilgisidir.

CUSTOMER

Parametre	Tip	Zorunlu	Açıklama
FIRST_NAME	string	Evet	İşlemi gerçekleştiren kullanıcının(müşterinin) adı bilgisidir.
LAST_NAME	string	Evet	İşlemi gerçekleştiren kullanıcının(müşterinin) soyadı bilgisidir.
MAIL	string	Evet	İşlemi gerçekleştiren kullanıcının(müşterinin) mail bilgisidir.
PHONE	string	Evet	İşlemi gerçekleştiren kullanıcının(müşterinin) telefon bilgisidir.
CITY	string	Evet	İşlemi gerçekleştiren kullanıcının(müşterinin) şehir bilgisidir.
STATE	string	Evet	İşlemi gerçekleştiren kullanıcının(müşterinin) ilçe bilgisidir.
ADDRESS	string	Evet	İşlemi gerçekleştiren kullanıcının(müşterinin) adres bilgisidir.
CLIENT_IP	string	Evet	İşlemi gerçekleştiren kullanıcının(müşterinin) IP adres bilgisidir.

Servise gönderilecek örnek bir JSON dosyası şu şekildedir;

                                            
{
    "Config" : {
        "MERCHANT": "TEST1234", 
        "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==",
        "BACK_URL" : "İşlem sonucunun üye iş yerine döndürüleceği url adresi",
        "PRICES_CURRENCY":"TRY",
        "ORDER_REF_NUMBER":"ORDER_REF_NUMBER",
        "ORDER_AMOUNT":"100.00",
        "REPEAT": 5,
        "TRIES_COUNT": 3,
        "START_DATE": "2022-09-06"
    },
    "Cards" : [
        {
        "CC_NUMBER":"4531444531442283",
        "EXP_MONTH":"12",
        "EXP_YEAR":"2026",
        "CC_CVV":"111",
        "CC_OWNER":"TEST USER"
        },
        {
        "CC_NUMBER":"4531444531442283",
        "EXP_MONTH":"12",
        "EXP_YEAR":"2026",
        "CC_CVV":"111",
        "CC_OWNER":"TEST USER"
        }
    ],
    "Customer" : {
        "FIRST_NAME":"Firstname",
        "LAST_NAME":"Lastname",
        "MAIL":"[email protected]",
        "PHONE":"1122356600",
        "CITY":"Istanbul",
        "STATE":"Kağıthane",
        "ADDRESS":"Merkez Mahallesi, Ayazma Cd. No:37/91 Papirus Plaza Kat:5, 34406",
        "CLIENT_IP":"123.44.66.38"
    }
}

                                            
                                        

Servisten işlem sonrasında gönderilen cevap mesajına ait parametreler şu şekildedir;

Ödeme Alma Servisi Cevap Mesajı Parametreleri

Parametre	Tip	Zorunlu	Açıklama
STATUS	string	Evet	Durum bilgisidir.
RETURN_CODE	string	Evet	Bakiye sorgulama işlemi sonucu durumu kod bilgisidir.
RETURN_MESSAGE	string	Evet	Bakiye sorgulama işlemi sonucu durum mesaj bilgisidir.

                                            
{
    "STATUS": "SUCCESS",
    "RETURN_CODE": "0",
    "RETURN_MESSAGE": null,
}
                                            
                                        

Ödeme Alma servisi cevap mesajında STATUS parametresinin değeri SUCCESS ve RETURN_CODE parametresinin değeri 0 olarak dönmesi Ödeme Alma servisinin başarılı olarak gerçekleştiğini ifade etmektedir.

İşlem Sonucu Bildirimi

Ödemeye ait her tekrarın sonucu ödeme alma servisi istek mesajı parametreleri arasında yer alan BACK_URL adresine aşağıdaki değerler ile JSON formatında POST edilerek bildirilir.

                                            
{
  "RETURN_CODE": "0",
  "RETURN_MESSAGE": "",
  "ORDER_REF_NUMBER": "212",
  "REPEAT_NUMBER": "1",
  "REPEAT_ORDER_REF_NUMBER": "e4dbfa5e-f0f4-45df-9c43-72ecade89f47507161",
}