Payment API Dökümanı v1.4 # Son Güncelleme: 26 Kasım 2024

Sistemi kullanan veya kullanacak olan bahis şirketleri Merchant sıfatı ile bilinecektir.

Servis sağlayıcıları BankoPay API ’lerini kullanmadan önce isteklerin gönerileceği IP adreslerini BankoPay developerlarına iletmelidir.

Servis sağlayıcısının whitelist etmesi gereken ip adresi: 136.244.90.110

BankoPay anlaşma sağladığı Merchant ’lara özel credentials (site_id ve site_key) iletmektedir. Merchant bu credentials (site_id ve site_key) bilgilerini servis sağlayıcısına ileterek sisteme entegre olacaktır.

Yatırım İşlemleri

Banka Havalesi ile para yatırma

BankoPay sistemindeki Banka Havalesi yatırım yöntemi işleyişi aşağıdaki şekildedir:

Müşteri bahis sitesindeki BankoPay Banka Havalesi yatırım formuna girer.
Karşısına çıkan “İşleme Başla” butonuna tıklar ve aşağıdaki linke yönlendirilir:
https://bankopay.co/deposit/bank-transfer?site_id=_SITEID_&username=_USERNAME_&user_id=_USERID_&fullname=_FULLNAME_&amount=_DEPOSITAMOUNT_&trx=_TRANSACTIONID_&return_url=_RETURNURL_
İşlemin geriye kalan kısmı BankoPay sitesinden yapılır.
Bu yöntemde kullanılabilecek tüm GET parametreleri aşağıdaki tabloda belirtilmiştir.

GET parametreleri:

Parametre	Gereklilik	Açıklama
site_id	required	BankoPay tarafından siteye özel verilir.
username	required	Müşterinin kullanıcı adı.
user_id	required	Müşterinin ID’si.
fullname	required	Müşterinin tam ismi (İlk adı İkinci adı Soyadı)
amount	required	Para yatırma miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
trx	required	İşlemin Merchant sistemindeki ID’si.
return_url	required	Merchant sitesinin mevcut URL’i.

Papara ile para yatırma

BankoPay sistemindeki Papara yatırım yöntemi işleyişi aşağıdaki şekildedir:

Müşteri bahis sitesindeki BankoPay Papara yatırım formuna girer.
Karşısına çıkan “İşleme Başla” butonuna tıklar ve aşağıdaki linke yönlendirilir:
https://bankopay.co/deposit/papara?site_id=_SITEID_&username=_USERNAME_&user_id=_USERID_&fullname=_FULLNAME_&amount=_DEPOSITAMOUNT_&trx=_TRANSACTIONID_&return_url=_RETURNURL_
İşlemin geriye kalan kısmı BankoPay sitesinden yapılır.
Bu yöntemde kullanılabilecek tüm GET parametreleri aşağıdaki tabloda belirtilmiştir.

GET parametreleri:

Parametre	Gereklilik	Açıklama
site_id	required	BankoPay tarafından siteye özel verilir.
username	required	Müşterinin kullanıcı adı.
user_id	required	Müşterinin ID’si.
fullname	required	Müşterinin tam ismi (İlk adı İkinci adı Soyadı)
amount	required	Para yatırma miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
trx	required	İşlemin Merchant sistemindeki ID’si.
return_url	required	Merchant sitesinin mevcut URL’i.

PopyPara ile para yatırma

BankoPay sistemindeki PopyPara yatırım yöntemi işleyişi aşağıdaki şekildedir:

Müşteri bahis sitesindeki BankoPay PopyPara yatırım formuna girer.
Karşısına çıkan “İşleme Başla” butonuna tıklar ve aşağıdaki linke yönlendirilir:
https://bankopay.co/deposit/popypara?site_id=_SITEID_&username=_USERNAME_&user_id=_USERID_&fullname=_FULLNAME_&amount=_DEPOSITAMOUNT_&trx=_TRANSACTIONID_&return_url=_RETURNURL_
İşlemin geriye kalan kısmı BankoPay sitesinden yapılır.
Bu yöntemde kullanılabilecek tüm GET parametreleri aşağıdaki tabloda belirtilmiştir.

GET parametreleri:

Parametre	Gereklilik	Açıklama
site_id	required	BankoPay tarafından siteye özel verilir.
username	required	Müşterinin kullanıcı adı.
user_id	required	Müşterinin ID’si.
fullname	required	Müşterinin tam ismi (İlk adı İkinci adı Soyadı)
amount	required	Para yatırma miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
trx	required	İşlemin Merchant sistemindeki ID’si.
return_url	required	Merchant sitesinin mevcut URL’i.

Paratim ile para yatırma

BankoPay sistemindeki Paratim yatırım yöntemi işleyişi aşağıdaki şekildedir:

Müşteri bahis sitesindeki BankoPay Paratim yatırım formuna girer.
Karşısına çıkan “İşleme Başla” butonuna tıklar ve aşağıdaki linke yönlendirilir:
https://bankopay.co/deposit/paratim?site_id=_SITEID_&username=_USERNAME_&user_id=_USERID_&fullname=_FULLNAME_&amount=_DEPOSITAMOUNT_&trx=_TRANSACTIONID_&return_url=_RETURNURL_
İşlemin geriye kalan kısmı BankoPay sitesinden yapılır.
Bu yöntemde kullanılabilecek tüm GET parametreleri aşağıdaki tabloda belirtilmiştir.

GET parametreleri:

Parametre	Gereklilik	Açıklama
site_id	required	BankoPay tarafından siteye özel verilir.
username	required	Müşterinin kullanıcı adı.
user_id	required	Müşterinin ID’si.
fullname	required	Müşterinin tam ismi (İlk adı İkinci adı Soyadı)
amount	required	Para yatırma miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
trx	required	İşlemin Merchant sistemindeki ID’si.
return_url	required	Merchant sitesinin mevcut URL’i.

PayFix ile para yatırma

BankoPay sistemindeki PayFix yatırım yöntemi işleyişi aşağıdaki şekildedir:

Müşteri bahis sitesindeki BankoPay PayFix yatırım formuna girer.
Karşısına çıkan “İşleme Başla” butonuna tıklar ve aşağıdaki linke yönlendirilir:
https://bankopay.co/deposit/payfix?site_id=_SITEID_&username=_USERNAME_&user_id=_USERID_&fullname=_FULLNAME_&amount=_DEPOSITAMOUNT_&trx=_TRANSACTIONID_&return_url=_RETURNURL_
İşlemin geriye kalan kısmı BankoPay sitesinden yapılır.
Bu yöntemde kullanılabilecek tüm GET parametreleri aşağıdaki tabloda belirtilmiştir.

GET parametreleri:

Parametre	Gereklilik	Açıklama
site_id	required	BankoPay tarafından siteye özel verilir.
username	required	Müşterinin kullanıcı adı.
user_id	required	Müşterinin ID’si.
fullname	required	Müşterinin tam ismi (İlk adı İkinci adı Soyadı)
amount	required	Para yatırma miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
trx	required	İşlemin Merchant sistemindeki ID’si.
return_url	required	Merchant sitesinin mevcut URL’i.

PayCo ile para yatırma

BankoPay sistemindeki PayCo yatırım yöntemi işleyişi aşağıdaki şekildedir:

Müşteri bahis sitesindeki BankoPay PayCo yatırım formuna girer.
Karşısına çıkan “İşleme Başla” butonuna tıklar ve aşağıdaki linke yönlendirilir:
https://bankopay.co/deposit/payco?site_id=_SITEID_&username=_USERNAME_&user_id=_USERID_&fullname=_FULLNAME_&amount=_DEPOSITAMOUNT_&trx=_TRANSACTIONID_&return_url=_RETURNURL_
İşlemin geriye kalan kısmı BankoPay sitesinden yapılır.
Bu yöntemde kullanılabilecek tüm GET parametreleri aşağıdaki tabloda belirtilmiştir.

GET parametreleri:

Parametre	Gereklilik	Açıklama
site_id	required	BankoPay tarafından siteye özel verilir.
username	required	Müşterinin kullanıcı adı.
user_id	required	Müşterinin ID’si.
fullname	required	Müşterinin tam ismi (İlk adı İkinci adı Soyadı)
amount	required	Para yatırma miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
trx	required	İşlemin Merchant sistemindeki ID’si.
return_url	required	Merchant sitesinin mevcut URL’i.

Çekim İşlemleri

Merchant’ın servis sağlayıcısı bu servisleri kullanarak BankoPay sistemine callback gönderecektir.

Site Provider → BankoPay

Banka Havalesi ile para çekme

Müşterinin yazdığı bilgiler BankoPay API servisi kullanılarak bize iletilmelidir...

BankoPay sistemindeki Banka Havalesi çekim yöntemi işleyişi aşağıdaki şekildedir:

Müşteri Merchant sitesindeki Banka Havalesi ile para çekme formuna girer.
Bu alandan para çekme form doldurulur;

Para çekme formunda olması gereken bilgiler:

Banka (select ile eklenmelidir. Lütfen inceleyin)
IBAN
Miktar
TC kimlik numarası
Doğum tarihi

Form bilgilerin yanısıra callback yaparken aşağıdaki bilgilerin de gönderilmesi gerekmektedir:

Merchant site_id
Merchant site_key
Kullanıcı ID
Kullanıcı adı
Kullanıcı tam ismi

Çekim talebi merchant sitenin yönetim panelinden kontrol edildikten sonra işlem “Geçerli” olarak işaretlendiği zaman BankoPay /withdraw/bank-transfer API servisine bilgiler post edilir.
Response içerisindeki code parametresi baz alınarak eğer;

code == 200 ise müşterinin talebi bize ulaşmıştır. (Servis sağlayıcısı sisteminde para çekme talebinin durumu “Beklemede” olarak değiştirilmelidir.)
code != 200 ise çekim talebi kabul edilmez ve servis sağlayıcısının sisteminde doğrudan redd edilmelidir. Red etme nedenine ise response içerisindeki message yazılmalıdır.

Papara ile para çekme

Müşterinin yazdığı bilgiler BankoPay API servisi kullanılarak bize iletilmelidir...

BankoPay sistemindeki Papara çekim yöntemi işleyişi aşağıdaki şekildedir:

Müşteri Merchant sitesindeki Papara ile para çekme formuna girer.
Bu alandan para çekme form doldurulur;

Para çekme formunda olması gereken bilgiler:

Papara hesap numarası
Miktar

Form bilgilerin yanısıra callback yaparken aşağıdaki bilgilerin de gönderilmesi gerekmektedir:

Merchant site_id
Merchant site_key
Kullanıcı ID
Kullanıcı adı
Kullanıcı tam ismi

Çekim talebi merchant sitenin yönetim panelinden kontrol edildikten sonra işlem “Geçerli” olarak işaretlendiği zaman BankoPay /withdraw/papara API servisine bilgiler post edilir.
Response içerisindeki code parametresi baz alınarak eğer;

code == 200 ise müşterinin talebi bize ulaşmıştır. (Servis sağlayıcısı sisteminde para çekme talebinin durumu “Beklemede” olarak değiştirilmelidir.)
code != 200 ise çekim talebi kabul edilmez ve servis sağlayıcısının sisteminde doğrudan redd edilmelidir. Red etme nedenine ise response içerisindeki message yazılmalıdır.

PopyPara ile para çekme

Müşterinin yazdığı bilgiler BankoPay API servisi kullanılarak bize iletilmelidir...

BankoPay sistemindeki PopyPara çekim yöntemi işleyişi aşağıdaki şekildedir:

Müşteri Merchant sitesindeki PopyPara ile para çekme formuna girer.
Bu alandan para çekme form doldurulur;

Para çekme formunda olması gereken bilgiler:

PopyPara hesap numarası
Miktar

Form bilgilerin yanısıra callback yaparken aşağıdaki bilgilerin de gönderilmesi gerekmektedir:

Merchant site_id
Merchant site_key
Kullanıcı ID
Kullanıcı adı
Kullanıcı tam ismi

Çekim talebi merchant sitenin yönetim panelinden kontrol edildikten sonra işlem “Geçerli” olarak işaretlendiği zaman BankoPay /withdraw/popypara API servisine bilgiler post edilir.
Response içerisindeki code parametresi baz alınarak eğer;

code == 200 ise müşterinin talebi bize ulaşmıştır. (Servis sağlayıcısı sisteminde para çekme talebinin durumu “Beklemede” olarak değiştirilmelidir.)
code != 200 ise çekim talebi kabul edilmez ve servis sağlayıcısının sisteminde doğrudan redd edilmelidir. Red etme nedenine ise response içerisindeki message yazılmalıdır.

Paratim ile para çekme

Müşterinin yazdığı bilgiler BankoPay API servisi kullanılarak bize iletilmelidir...

BankoPay sistemindeki Paratim çekim yöntemi işleyişi aşağıdaki şekildedir:

Müşteri Merchant sitesindeki Paratim ile para çekme formuna girer.
Bu alandan para çekme form doldurulur;

Para çekme formunda olması gereken bilgiler:

Paratim hesap numarası
Miktar

Form bilgilerin yanısıra callback yaparken aşağıdaki bilgilerin de gönderilmesi gerekmektedir:

Merchant site_id
Merchant site_key
Kullanıcı ID
Kullanıcı adı
Kullanıcı tam ismi

Çekim talebi merchant sitenin yönetim panelinden kontrol edildikten sonra işlem “Geçerli” olarak işaretlendiği zaman BankoPay /withdraw/paratim API servisine bilgiler post edilir.
Response içerisindeki code parametresi baz alınarak eğer;

code == 200 ise müşterinin talebi bize ulaşmıştır. (Servis sağlayıcısı sisteminde para çekme talebinin durumu “Beklemede” olarak değiştirilmelidir.)
code != 200 ise çekim talebi kabul edilmez ve servis sağlayıcısının sisteminde doğrudan redd edilmelidir. Red etme nedenine ise response içerisindeki message yazılmalıdır.

PayFix ile para çekme

Müşterinin yazdığı bilgiler BankoPay API servisi kullanılarak bize iletilmelidir...

BankoPay sistemindeki PayFix çekim yöntemi işleyişi aşağıdaki şekildedir:

Müşteri Merchant sitesindeki PayFix ile para çekme formuna girer.
Bu alandan para çekme form doldurulur;

Para çekme formunda olması gereken bilgiler:

PayFix hesap numarası
Miktar

Form bilgilerin yanısıra callback yaparken aşağıdaki bilgilerin de gönderilmesi gerekmektedir:

Merchant site_id
Merchant site_key
Kullanıcı ID
Kullanıcı adı
Kullanıcı tam ismi

Çekim talebi merchant sitenin yönetim panelinden kontrol edildikten sonra işlem “Geçerli” olarak işaretlendiği zaman BankoPay /withdraw/payfix API servisine bilgiler post edilir.
Response içerisindeki code parametresi baz alınarak eğer;

code == 200 ise müşterinin talebi bize ulaşmıştır. (Servis sağlayıcısı sisteminde para çekme talebinin durumu “Beklemede” olarak değiştirilmelidir.)
code != 200 ise çekim talebi kabul edilmez ve servis sağlayıcısının sisteminde doğrudan redd edilmelidir. Red etme nedenine ise response içerisindeki message yazılmalıdır.

PayCo ile para çekme

Müşterinin yazdığı bilgiler BankoPay API servisi kullanılarak bize iletilmelidir...

BankoPay sistemindeki PayCo çekim yöntemi işleyişi aşağıdaki şekildedir:

Müşteri Merchant sitesindeki PayCo ile para çekme formuna girer.
Bu alandan para çekme form doldurulur;

Para çekme formunda olması gereken bilgiler:

PayCo hesap numarası
Miktar

Form bilgilerin yanısıra callback yaparken aşağıdaki bilgilerin de gönderilmesi gerekmektedir:

Merchant site_id
Merchant site_key
Kullanıcı ID
Kullanıcı adı
Kullanıcı tam ismi

Çekim talebi merchant sitenin yönetim panelinden kontrol edildikten sonra işlem “Geçerli” olarak işaretlendiği zaman BankoPay /withdraw/payco API servisine bilgiler post edilir.
Response içerisindeki code parametresi baz alınarak eğer;

code == 200 ise müşterinin talebi bize ulaşmıştır. (Servis sağlayıcısı sisteminde para çekme talebinin durumu “Beklemede” olarak değiştirilmelidir.)
code != 200 ise çekim talebi kabul edilmez ve servis sağlayıcısının sisteminde doğrudan redd edilmelidir. Red etme nedenine ise response içerisindeki message yazılmalıdır.

Çekim Servisleri

Servis: /api/withdraw/bank-transfer

POST: https://bankopay.co/api/withdraw/bank-transfer

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
trx	required	string	Çekimin Merchant sistemindeki ID’si.
fullname	required	string	Müşterinin tam adı.
amount	required	string	Para çekme miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
account_number	required	string	IBAN.
provider_id	required	integer	Çekim yapılacak Bankanın ID’si. Lütfen inceleyin.
identity	required	string	TC kimlik numarası.
birth_date	required	string	Doğum tarihi.

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu. Lütfen inceleyin.
message	string	Durum mesajı. Lütfen inceleyin.

Örnek:

POST: https://bankopay.co/api/withdraw/bank-transfer

Accept: application/json
Content-Type: application/json

Request:

{
  "site_id": 1001,
  "site_key": "k62FdW0BaEXn3iUrzuDXcwiNQIYqmorU",
  "user_id": "1254137",
  "username": "demo123",
  "trx": "456454646",
  "fullname": "Ahmet Demir",
  "amount": 250.00,
  "account_number": "TR123445678945613245645",
  "identity": "12345678910",
  "birth_date": "16.09.1990",
  "provider_id": 1
}

Response (Başarılı işlem için)

{
  "message": "Çekim Talebi oluşturuldu",
  "code": 200,
  "type": "success",
  "data": {
    "site_id": 1,
    "user_id": "1254137",
    "username": "demo123",
    "trx": "456454646",
    "fullname": "Ahmet Demir",
    "amount": 250,
    "account_number": "TR123445678945613245645",
    "identity": "12345678910",
    "birth_date": "16.09.1990",
    "provider_id": 1,
    "callback_data": "{\"site_id\":1,\"site_key\":\"abc\",\"user_id\":\"1254137\",\"username\":\"demo123\",\"trx\":\"456454646\",\"fullname\":\"Ahmet Demir\",\"amount\":250,\"account_number\":\"TR123445678945613245645\",\"identity\":\"12345678910\",\"birth_date\":\"16.09.1990\",\"provider_id\":1}",
    "updated_at": "17.02.2024 00:28:46",
    "created_at": "17.02.2024 00:28:46",
    "id": 2
  }
}

Response (Hatalı işlem için)

{
"code": 20014,
"message": "API credentials hatalıdır!",
"type": "error"
}

Not: Eğer code 200 değil ise çekim talebi kabul edilmemeli ve panele message bilgisi redd etme nedeni olarak kaydedilmelidir.

Servis: /api/withdraw/papara

POST: https://bankopay.co/api/withdraw/papara

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
trx	required	string	Çekimin Merchant sistemindeki ID’si.
fullname	required	string	Müşterinin tam adı.
amount	required	string	Para çekme miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
account_number	required	string	Papara hesap numarası

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu. Lütfen inceleyin.
message	string	Durum mesajı. Lütfen inceleyin.

Örnek:

POST: https://bankopay.co/api/withdraw/papara

Accept: application/json
Content-Type: application/json

Request:

Response (Başarılı işlem için)

{
  "message": "Çekim Talebi oluşturuldu",
  "code": 200,
  "type": "success",
  "data": {
    "site_id": 1,
    "user_id": "1254137",
    "username": "demo123",
    "trx": "456454646",
    "fullname": "Ahmet Demir",
    "amount": 250,
    "account_number": "TR123445678945613245645",
    "callback_data": "{\"site_id\":1,\"site_key\":\"abc\",\"user_id\":\"1254137\",\"username\":\"demo123\",\"trx\":\"456454646\",\"fullname\":\"Ahmet Demir\",\"amount\":250,\"account_number\":\"TR123445678945613245645\",\"identity\":\"12345678910\",\"birth_date\":\"16.09.1990\",\"provider_id\":1}",
    "updated_at": "17.02.2024 00:28:46",
    "created_at": "17.02.2024 00:28:46",
    "id": 2
  }
}

Response (Hatalı işlem için)

{
"code": 20014,
"message": "API credentials hatalıdır!",
"type": "error"
}

Not: Eğer code 200 değil ise çekim talebi kabul edilmemeli ve panele message bilgisi redd etme nedeni olarak kaydedilmelidir.

Servis: /api/withdraw/popypara

POST: https://bankopay.co/api/withdraw/popypara

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
trx	required	string	Çekimin Merchant sistemindeki ID’si.
fullname	required	string	Müşterinin tam adı.
amount	required	string	Para çekme miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
account_number	required	string	PopyPara hesap numarası

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu. Lütfen inceleyin.
message	string	Durum mesajı. Lütfen inceleyin.

Örnek:

POST: https://bankopay.co/api/withdraw/popypara

Accept: application/json
Content-Type: application/json

Request:

Response (Başarılı işlem için)

{
  "message": "Çekim Talebi oluşturuldu",
  "code": 200,
  "type": "success",
  "data": {
    "site_id": 1,
    "user_id": "1254137",
    "username": "demo123",
    "trx": "456454646",
    "fullname": "Ahmet Demir",
    "amount": 250,
    "account_number": "202400138923",
    "callback_data": "{\"site_id\":1,\"site_key\":\"abc\",\"user_id\":\"1254137\",\"username\":\"demo123\",\"trx\":\"456454646\",\"fullname\":\"Ahmet Demir\",\"amount\":250,\"account_number\":\"202400138923\",\"identity\":\"12345678910\",\"birth_date\":\"16.09.1990\",\"provider_id\":1}",
    "updated_at": "17.02.2024 00:28:46",
    "created_at": "17.02.2024 00:28:46",
    "id": 2
  }
}

Response (Hatalı işlem için)

{
"code": 20014,
"message": "API credentials hatalıdır!",
"type": "error"
}

Not: Eğer code 200 değil ise çekim talebi kabul edilmemeli ve panele message bilgisi redd etme nedeni olarak kaydedilmelidir.

Servis: /api/withdraw/paratim

POST: https://bankopay.co/api/withdraw/paratim

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
trx	required	string	Çekimin Merchant sistemindeki ID’si.
fullname	required	string	Müşterinin tam adı.
amount	required	string	Para çekme miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
account_number	required	string	Paratim hesap numarası

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu. Lütfen inceleyin.
message	string	Durum mesajı. Lütfen inceleyin.

Örnek:

POST: https://bankopay.co/api/withdraw/paratim

Accept: application/json
Content-Type: application/json

Request:

Response (Başarılı işlem için)

{
  "message": "Çekim Talebi oluşturuldu",
  "code": 200,
  "type": "success",
  "data": {
    "site_id": 1,
    "user_id": "1254137",
    "username": "demo123",
    "trx": "456454646",
    "fullname": "Ahmet Demir",
    "amount": 250,
    "account_number": "202400138923",
    "callback_data": "{\"site_id\":1,\"site_key\":\"abc\",\"user_id\":\"1254137\",\"username\":\"demo123\",\"trx\":\"456454646\",\"fullname\":\"Ahmet Demir\",\"amount\":250,\"account_number\":\"202400138923\",\"identity\":\"12345678910\",\"birth_date\":\"16.09.1990\",\"provider_id\":1}",
    "updated_at": "17.02.2024 00:28:46",
    "created_at": "17.02.2024 00:28:46",
    "id": 2
  }
}

Response (Hatalı işlem için)

{
"code": 20014,
"message": "API credentials hatalıdır!",
"type": "error"
}

Not: Eğer code 200 değil ise çekim talebi kabul edilmemeli ve panele message bilgisi redd etme nedeni olarak kaydedilmelidir.

Servis: /api/withdraw/payfix

POST: https://bankopay.co/api/withdraw/payfix

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
trx	required	string	Çekimin Merchant sistemindeki ID’si.
fullname	required	string	Müşterinin tam adı.
amount	required	string	Para çekme miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
account_number	required	string	Payfix hesap numarası

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu. Lütfen inceleyin.
message	string	Durum mesajı. Lütfen inceleyin.

Örnek:

POST: https://bankopay.co/api/withdraw/payfix

Accept: application/json
Content-Type: application/json

Request:

Response (Başarılı işlem için)

{
  "message": "Çekim Talebi oluşturuldu",
  "code": 200,
  "type": "success",
  "data": {
    "site_id": 1,
    "user_id": "1254137",
    "username": "demo123",
    "trx": "456454646",
    "fullname": "Ahmet Demir",
    "amount": 250,
    "account_number": "202400138923",
    "callback_data": "{\"site_id\":1,\"site_key\":\"abc\",\"user_id\":\"1254137\",\"username\":\"demo123\",\"trx\":\"456454646\",\"fullname\":\"Ahmet Demir\",\"amount\":250,\"account_number\":\"202400138923\",\"identity\":\"12345678910\",\"birth_date\":\"16.09.1990\",\"provider_id\":1}",
    "updated_at": "17.02.2024 00:28:46",
    "created_at": "17.02.2024 00:28:46",
    "id": 2
  }
}

Response (Hatalı işlem için)

{
"code": 20014,
"message": "API credentials hatalıdır!",
"type": "error"
}

Not: Eğer code 200 değil ise çekim talebi kabul edilmemeli ve panele message bilgisi redd etme nedeni olarak kaydedilmelidir.

Servis: /api/withdraw/payco

POST: https://bankopay.co/api/withdraw/payco

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
trx	required	string	Çekimin Merchant sistemindeki ID’si.
fullname	required	string	Müşterinin tam adı.
amount	required	string	Para çekme miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
account_number	required	string	PayCo hesap numarası

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu. Lütfen inceleyin.
message	string	Durum mesajı. Lütfen inceleyin.

Örnek:

POST: https://bankopay.co/api/withdraw/payco

Accept: application/json
Content-Type: application/json

Request:

Response (Başarılı işlem için)

{
  "message": "Çekim Talebi oluşturuldu",
  "code": 200,
  "type": "success",
  "data": {
    "site_id": 1,
    "user_id": "1254137",
    "username": "demo123",
    "trx": "456454646",
    "fullname": "Ahmet Demir",
    "amount": 250,
    "account_number": "202400138923",
    "callback_data": "{\"site_id\":1,\"site_key\":\"abc\",\"user_id\":\"1254137\",\"username\":\"demo123\",\"trx\":\"456454646\",\"fullname\":\"Ahmet Demir\",\"amount\":250,\"account_number\":\"202400138923\",\"identity\":\"12345678910\",\"birth_date\":\"16.09.1990\",\"provider_id\":1}",
    "updated_at": "17.02.2024 00:28:46",
    "created_at": "17.02.2024 00:28:46",
    "id": 2
  }
}

Response (Hatalı işlem için)

{
"code": 20014,
"message": "API credentials hatalıdır!",
"type": "error"
}

Not: Eğer code 200 değil ise çekim talebi kabul edilmemeli ve panele message bilgisi redd etme nedeni olarak kaydedilmelidir.

Servis: /api/bank-list/

POST: https://bankopay.co/api/bank-list/

Accept: application/json
Content-Type: application/json

Request:

{
"site_id": 1001,
"site_key": "k62FdW0BaEXn3iUrzuDXcwiNQIYqmorU"
}

Response (Başarılı işlem için)

{
  "message": "Banka Listesi",
  "code": 200,
  "type": "success",
  "data": [
    {
      "provider_name": "Test - Garanti Bankası",
      "id": "1"
    },
    {
      "provider_name": "Test - İş Bankası",
      "id": "2"
    }
  ]
}

Response (Hatalı işlem için)

{
  "code": 20014,
   "message": "API credentials hatalıdır!",
  "type": "error"
}

Response Kodları

Response bilgisi:

Code	Message
200	Çekim/Withdraw talebi oluşturuldu!
20014	API credentials hatalıdır!

Callback Servisleri

Callback Return API Servisleri

Kullanacağımız Callback servisleri

Bu başlık altında anlatılacak olan servisler BankoPay sisteminin çalışması için Merchant ’ın servis sağlayıcısının sistemine eklenmelidir.

BankoPay bu servisleri kullanarak servis sağlayıcısının sistemine callback gönderecektir.

BankoPay → Site Provider

POST: https://yourdomain/.com/api/BankoPay/

Kullanılacak servisler:

Servis	Açıklama
info	Bu servisi kullanarak Merchant sitesinde bir müşterinin hesabının var olup olmadığının, gönderilen trx’in bu müşteriye ait olup olmadığının ve bu trx’in durumunun beklemede olup olmadığının kontrolünü yapabilmemiz gerekir.
deposit	Bu servisi kullanarak Merchant sitesindeki bir müşterinin hesap bakiyesine ekleme yapabilmemiz gerekir.
withdraw	Bu servisi kullanarak Merchant sitesindeki bir müşterinin BankoPay ile oluşturulmuş para çekme talebini sonuçlandırabilmemiz gerekir.

Başlık bilgileri:

Başlık	Değer
Accept	application/json
Content-Type	application/json

Callback Servis: info

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
data	optional	string	Yatırım işleminin başında, eğer müşteriyi BankoPay sayfasına yönlendirirken bu parametreyi göndermişseniz, biz bu servise callback yaparken bu parametrenin içerisindeki veriyi size geri ileteceğiz.
trx	required	string	Yatırım işleminin başında, eğer müşteriyi BankoPay sayfasına yönlendirirken bu parametreyi göndermişseniz, biz bu servise callback yaparken bu parametrenin içerisindeki veriyi size geri ileteceğiz.
hash	required	string	Hash için neye ihtiyacınız var? `site_id\|user_id\|trx\|site_key` bu kombinasyon ile hash oluşturabilirsiniz. Hash için BCRYPT paketini kullanıyoruz. https://github.com/pyca/bcrypt

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu.
message	string	Durum mesajı.

Örnek:

POST: https://yourdomain.com/api/BankoPay/info/

Accept: application/json
Content-Type: application/json

Request:

{
  "site_id": 1001,
  "site_key": "k62FdW0BaEXn3iUrzuDXcwiNQIYqmorU",
  "service": "info",
  "user_id": "44843155",
  "username": "demo123",
  "trx": "9164088",
  "hash": "$2a$12$gnZ3y0PcBIrKlk7lLCOZK.V5nnggrA2Vg2pyUMlpE24m3QAU30rmS"
}

Response (Başarılı işlem için)

{
"code": 200,
"message": "Yatırım gerçekleştirelebilir!"
}

Response (Hatalı işlem için)

{
"code": 999,
"message": "HATA MESAJI"
}

Not: Biz sadece code : 200 durumunda işleme devam ederiz. Eğer code : 200 değil ise işlemi sonlandırırız.

Callback Servis: deposit

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
method	required	string	“BankTransfer”, “Papara”, “Parazula”, “Popypara”, “Paratim”, “PayFix”, “PayCo” olarak gönderilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
amount	required	string	Müşteri bakiyesine eklenecek miktar.
currency	required	string	“TRY” olarak gönderilir.
transaction_id	required	string	İşleminin bizim sistemdeki ID’si.
status	required	string	Status "approved" veya "reject" olarak işlem durumuna göre gönderilir. "approved" : başarılı bir şekilde onaylandı. "reject" : red edildi
trx	required	string	Yatırım işleminin başında, eğer müşteriyi BankoPay sayfasına yönlendirirken bu parametreyi göndermişseniz, biz bu servise callback yaparken bu parametrenin içerisindeki veriyi size geri ileteceğiz.
hash	required	string	Hash için neye ihtiyacınız var? `site_id\|user_id\|trx\|site_key` bu kombinasyon ile hash oluşturabilirsiniz. Hash için BCRYPT paketini kullanıyoruz. https://github.com/pyca/bcrypt

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu.
message	string	Durum mesajı.

Örnek:

POST: https://yourdomain.com/api/BankoPay/deposit/

Accept: application/json
Content-Type: application/json

Request:

{
  "site_id": 1001,
  "site_key": "k62FdW0BaEXn3iUrzuDXcwiNQIYqmorU",
  "service": "deposit",
  "method": "BankTransfer",
  "user_id": "44843155",
  "username": "demo123",
  "amount": "200.00",
  "currency": "TRY",
  "transaction_id": "MD10001",
  "status": "approved",
  "trx": "9164088",
  "hash": "$2a$12$gnZ3y0PcBIrKlk7lLCOZK.V5nnggrA2Vg2pyUMlpE24m3QAU30rmS"
}

Response (Başarılı işlem için)

{
"code": 200,
"message": "Hesaba bakiye eklendi!"
}

Response (Hatalı işlem için)

{
"code": 999,
"message": "HATA MESAJI"
}

Not: Biz sadece code : 200 durumunda işleme devam ederiz. Eğer code : 200 değil ise işlemi sonlandırırız.

Callback Servis: withdraw

Request içeriği:

Parametre	Gereklilik	Tür	Açıklama
site_id	required	integer	BankoPay tarafından siteye özel verilir.
site_key	required	string	BankoPay tarafından siteye özel verilir.
method	required	string	“BankTransfer”, “Papara”, “Parazula”, “Popypara”, “Paratim”, “PayFix”, “PayCo” olarak gönderilir.
user_id	required	string	Müşterinin ID’si.
username	required	string	Müşterinin kullanıcı adı.
amount	required	string	Çekim miktarı. 25000.00 veya 25000, 25 Bin TL’yi temsil eder.
currency	required	string	“TRY” olarak gönderilir.
transaction_id	required	string	İşleminin bizim sistemdeki ID’si.
trx	required	string	Çekim işleminin Merchant sistemindeki ID’si.
status	required	string	Status "approved" veya "reject" olarak işlem durumuna göre gönderilir. "approved" : başarılı bir şekilde onaylandı. "reject" : red edildi
message	required	string	Çekim işleminin sonucuna dair not. C durumunda Tamamlandı, R durumunda ise redd etme nedeni yazar.
hash	required	string	Hash için neye ihtiyacınız var? `site_id\|user_id\|trx\|site_key` bu kombinasyon ile hash oluşturabilirsiniz. Hash için BCRYPT paketini kullanıyoruz. https://github.com/pyca/bcrypt

Response içeriği:

Parametre	Tür	Açıklama
code	integer	Durum kodu.
message	string	Durum mesajı.

Örnek:

POST: https://yourdomain.com/api/BankoPay/withdraw/

Accept: application/json
Content-Type: application/json

Request:

{
  "site_id": 1001,
  "site_key": "k62FdW0BaEXn3iUrzuDXcwiNQIYqmorU",
  "service": "withdraw",
  "method": "BankTransfer",
  "user_id": "44843155",
  "username": "demo123",
  "amount": "200.00",
  "currency": "TRY",
  "transaction_id": "MW10001",
  "trx": "451474562",
  "status": "approved",
  "message": "Tamamlandı!",
  "hash": "$2a$12$gnZ3y0PcBIrKlk7lLCOZK.V5nnggrA2Vg2pyUMlpE24m3QAU30rmS"
}

Response (Başarılı işlem için)

{
"code": 200,
"message": "Hesaba bakiye eklendi!"
}

Response (Hatalı işlem için)

{
"code": 999,
"message": "HATA MESAJI"
}

Not: Biz sadece code : 200 durumunda işleme devam ederiz. Eğer code : 200 değil ise işlemi sonlandırırız.

Banka Havalesi ile para yatırma

Papara ile para yatırma

PopyPara ile para yatırma

Paratim ile para yatırma

PayFix ile para yatırma

PayCo ile para yatırma

Banka Havalesi ile para çekme

Papara ile para çekme

PopyPara ile para çekme

Paratim ile para çekme

PayFix ile para çekme

PayCo ile para çekme

Servis: /api/withdraw/bank-transfer

Örnek:

Servis: /api/withdraw/papara

Örnek:

Servis: /api/withdraw/popypara

Örnek:

Servis: /api/withdraw/paratim

Örnek:

Servis: /api/withdraw/payfix

Örnek:

Servis: /api/withdraw/payco

Örnek:

Servis: /api/bank-list/

Response Kodları

Callback Servis: info

Hash için neye ihtiyacınız var?

Örnek:

Callback Servis: deposit

Hash için neye ihtiyacınız var?

Örnek:

Callback Servis: withdraw

Hash için neye ihtiyacınız var?

Örnek: