Link ve QR Kod İle Ödeme Alma

Link ve QR Kod ile ödeme almak için Craftgate üzerinde link oluşturabilir, bu linki paylaşabilir ve herhangi bir teknik entegrasyona ihtiyaç duymadan kolayca ödeme alabilirsiniz.

Link Oluşturma

Link oluşturmak için gerekli bilgilere aşağıda yer verilmiştir.

URL

POST/craftlink/v1/products

İstek Parametreleri

Link oluşturmak için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.

name

string

zorunlu

Oluşturmak istediğiniz link'e isim vermek için kullanılabilir.

description

string

zorunlu

Oluşturmak istediğiniz linke ait detayları göstermek için kullanılabilir. Koyu yazı yapmak istediğiniz bölümü ** işaretleri arasına alabilirsiniz, mesela; ** Metin ** şeklinde. Açıklama kısmında her satırın sonuna \n ekleyerek alt satıra geçmesini sağlayabilirsiniz.

orderId

string

Bankaya iletilecek olan sipariş numarası. Sipariş numarası gönderildi ise stok değeri 1 gönderilmelidir.

price

number

zorunlu

Link'e ait fiyat.

currency

Currency

zorunlu

Ödemenin alınacağı para birimini ifade eder.

Değerler:

TRY

USD

EUR

GBP

CNY

ARS

BRL

AED

IQD

AZN

KZT

KWD

SAR

BHD

RUB

JPY

EGP

stock

number

Sınırlı sayıda yada stok durumu varsa bu alan kullanılabilir.

channel

string

Farklı kanallardan ödeme alıyorsanız bu alan üzerinden gruplayabilirsiniz.

multiPayment

boolean

Ödemenin parçalı olarak yapılıp yapılmayacağı bilgisini ifade eder.

enabledInstallments

number[]

zorunlu

Ödeme adımında gösterilecek taksitleri ifade eder.

Dönüş Parametreleri

Ödeme işleminin sonucunda dönen parametreler de API dokümantasyonu giriş sayfasındaki Dönüş Formatları bölümünde belirtilen kurallara tabidir. Sistemsel ya da kurgusal bir hata bulunmadığı durumda data parametresinde dönen objenin alt parametreleri aşağıdaki gibidir:

id

number

Link'e ait ID değeri

name

string

Link adı

description

string

Link açıklaması

channel

string

Link kanalı

orderId

string

Banka sipariş no

status

Status

Link durumu

Değerler:

ACTIVE

PASSIVE

price

number

Link fiyatı

currency

Currency

Link para birimi

Değerler:

TRY

USD

EUR

GBP

CNY

ARS

BRL

AED

IQD

AZN

KZT

KWD

SAR

BHD

RUB

JPY

EGP

stock

number

Link'e ait stock bilgisi.

soldCount

number

Link üzerinden kaç defa ödeme alındığını ifade eder.

token

string

Link'e ait token değeri.

multiPayment

boolean

Ödemenin parçalı olarak yapılıp yapılmayacağı bilgisini ifade eder.

enabledInstallments

number[]

Link ödemesinde kullanılabilecek taksit değerleri.

url

string

Link'e erişebileceğiniz url adresi.

qrCodeUrl

string

QR Kod'a erişebileceğiniz url adresi.

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.

Java.NETPHPNode.jsGo

Link Güncelleme

Link güncellemek için gerekli bilgilere aşağıda yer verilmiştir.

URL

PUT/craftlink/v1/products/:id

id

number

zorunlu

Link'e ait ID değeri

İstek Parametreleri

Link oluşturmak için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.

status

Status

zorunlu

Link durumu

Değerler:

ACTIVE

PASSIVE

name

string

zorunlu

Oluşturmak istediğiniz link'e isim vermek için kullanılabilir.

description

string

zorunlu

Oluşturmak istediğiniz link'e ait detay vermek için kullanılabilir.

orderId

string

Bankaya iletilecek olan sipariş numarası. Sipariş numarası gönderildi ise stok değeri 1 gönderilmelidir.

price

number

zorunlu

Link'e ait fiyat.

currency

Currency

zorunlu

Ödemenin alınacağı para birimini ifade eder.

Değerler:

TRY

USD

EUR

GBP

CNY

ARS

BRL

AED

IQD

AZN

KZT

KWD

SAR

BHD

RUB

JPY

EGP

stock

number

Sınırlı sayıda yada stok durumu varsa bu alan kullanılabilir.

channel

string

zorunlu

Farklı kanallardan ödeme alıyorsanız bu alan üzerinden gruplayabilirsiniz.

enabledInstallments

number[]

zorunlu

Ödeme adımında gösterilecek taksitleri ifade eder.

Dönüş Parametreleri

Ödeme işleminin sonucunda dönen parametreler de API dokümantasyonu giriş sayfasındaki Dönüş Formatları bölümünde belirtilen kurallara tabidir. Sistemsel ya da kurgusal bir hata bulunmadığı durumda data parametresinde dönen objenin alt parametreleri aşağıdaki gibidir:

Dönüş değeri için link cevabına bakabilirsiniz.

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.

Java.NETPHPNode.jsGo

Link Sorgulama

Link sorgulama için gerekli bilgilere aşağıda yer verilmiştir.

URL

GET/craftlink/v1/products/:id

id

number

zorunlu

Link'e ait ID değeri

Dönüş Parametreleri

Ödeme işleminin sonucunda dönen parametreler de API dokümantasyonu giriş sayfasındaki Dönüş Formatları bölümünde belirtilen kurallara tabidir. Sistemsel ya da kurgusal bir hata bulunmadığı durumda data parametresinde dönen objenin alt parametreleri aşağıdaki gibidir:

Dönüş değeri için link cevabına bakabilirsiniz.

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.

Java.NETPHPNode.jsGo

Link Silme

Link silmek için gerekli bilgilere aşağıda yer verilmiştir.

URL

DELETE/craftlink/v1/products/:id

id

number

zorunlu

Link'e ait ID değeri

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.

Java.NETPHPNode.jsGo

Link Arama

Link aramak için gerekli bilgilere aşağıda yer verilmiştir.

URL

GET/craftlink/v1/products

name

string

Link ismi

minPrice

number

Link fiyatı

maxPrice

number

Link fiyatı

currency

Currency

Link para birimi

Değerler:

TRY

USD

EUR

GBP

CNY

ARS

BRL

AED

IQD

AZN

KZT

KWD

SAR

BHD

RUB

JPY

EGP

channel

string

Link kanalı

page

number

Sayfalama için sayfa numarası

size

number

Sayfalama için sayfa büyüklüğü

Dönüş Parametreleri

Ödeme işleminin sonucunda dönen parametreler de API dokümantasyonu giriş sayfasındaki Dönüş Formatları bölümünde belirtilen kurallara tabidir. Sistemsel ya da kurgusal bir hata bulunmadığı durumda data parametresinde dönen objenin alt parametreleri aşağıdaki gibidir:

page

number

Link'e ait ID değeri

size

string

Link adı

totalSize

string

Link açıklaması

items

Link[]

Link listesi. Dönüş değeri için link cevabına bakabilirsiniz.

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.

Java.NETPHPNode.jsGo