Esnekpos Geliştirici Ortamı
  • Esnekpos Geliştirici Ortamı
    • Anasayfa
    • Başlangıç
    • Hazır Modüller
    • Entegrasyon
      • Test Ortamı
      • Gerçek(Prod) Ortam
    • Ödeme Servisleri
      • Ödeme Yöntemleri
      • 3D Ödeme
      • Ortak Ödeme Sayfası
    • Ödeme İsteği Servisi
      • Ödeme İsteği Gönderimi
      • Ödeme İsteği Durum Sorgulama
    • Tekrarlı Ödeme Servisi
      • Ödeme Alma Servisi
      • Tekrar İptal Etme Servisi
      • İşlem Listeleme Servisi
      • İşlem Sorgulama Servisi
      • Kart İptal Etme Servisi
      • Kart Ekleme Servisi
    • Android Pos Web Api
      • Pos Listeleme Servisi
      • Ödeme Servisi
      • İşlem İptal Servisi
    • BKM Express
      • Ortak Ödeme Sayfası İle BKM Express
      • Servis İle BKM Express
      • BKM Express Test Ortamı Bilgileri
    • Pazaryeri Entegrasyonu
      • Pazaryeri Entegrasyonu
      • Mağaza Tanımlama
      • Mağaza Sorgulama
      • Ödeme Alma
      • Ödeme Onaylama
      • İade Talebi
      • Mağaza Alacak Azaltma
    • İade/İptal Servisi
    • İşlem Listeleme Servisi
    • Android Pos İşlem Listeleme Servisi
    • Üye İşyeri Bakiye Sorgulama Servisi
    • İşlem Sorgulama Servisi
    • İşlem Sorgulama Servisi - Detaylı
    • Transfer Listeleme Servisi
    • Bin Sorgulama Servisi
    • Taksit Ve Oran Listeleme
    • Dekont Listeleme Servisi
    • Hata Kodları
Powered by GitBook
On this page
  1. Esnekpos Geliştirici Ortamı
  2. Tekrarlı Ödeme Servisi

Ö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",
}
PreviousTekrarlı Ödeme ServisiNextTekrar İptal Etme Servisi

Last updated 1 month ago