API entegrasyonu

Merchant API üzerinden harici kripto cüzdanlardan kripto para ödemeleri kabul edin.

API entegrasyonunda uygulamanız kripto faturaları oluşturur, müşterilere ödeme talimatlarını gösterir ve ödeme durumunu API veya Status URL bildirimleri üzerinden izler.

API'yi üç şekilde kullanabilirsiniz:

Durum sorgulamalı yalnızca API — uygulamanız tüm ödeme deneyimini oluşturur ve ödeme durumunu API üzerinden kontrol eder.
Status URL bildirimli yalnızca API — uygulamanız tüm ödeme deneyimini oluşturur, ödeme bildirimleri için kullanılan Status URL'yi ise bir Hosted Checkout yapılandırması sağlar. Hosted Checkout sayfasının kendisi kullanılmaz.
API + Hosted Checkout — arka ucunuz sipariş takibi ve mutabakat için API'yi kullanır, müşteriye yönelik ödeme sayfasını ise Hosted Checkout sağlar.

API entegrasyonu ne zaman kullanılır

Ödeme akışını kendi web sitenizde, uygulamanızda, botunuzda veya yapay zekâ ajanınızda kontrol etmek istediğinizde API entegrasyonunu kullanın.

API entegrasyonu şu durumlarda faydalıdır:

Kendi ödeme arayüzünüzü oluşturmak istiyorsanız.
Kripto faturalarını programatik olarak oluşturmanız gerekiyorsa.
Ödeme talimatlarını kendi ürününüzde göstermek istiyorsanız.
Ödeme durumunu arka ucunuzdan izlemeniz gerekiyorsa.
Ödeme durumu bildirimlerini kendi sunucunuzda almak istiyorsanız.
Hosted Checkout'u arka uçtaki sipariş mutabakatıyla birleştirmek istiyorsanız.

Hazır bir ödeme sayfasıyla en hızlı entegrasyonu istiyorsanız bunun yerine Hosted Checkout entegrasyonunu kullanın.

Entegrasyon modelleri

Model	Müşteri deneyimi	Arka ucun sorumluluğu	Durumun işlenmesi
Yalnızca API + sorgulama	Uygulamanız oluşturur	Fatura oluşturma, ödeme bilgilerini gösterme, durumu izleme	`GET /api/orders` ile düzenli sorgulama
Yalnızca API + Status URL	Uygulamanız oluşturur	Fatura oluşturma, ödeme bilgilerini gösterme, bildirimleri işleme	Hosted Checkout Status URL'si, mutabakat için API ile sorgulama
API + Hosted Checkout	Volet.com barındırır	Siparişleri izleme ve ödeme durumunun mutabakatı	Hosted Checkout Status URL'si, mutabakat için API ile sorgulama

Başlamadan önce

API üzerinden kripto ödeme kabul etmek için şunlara ihtiyacınız vardır:

Doğrulanmış bir Volet.com hesabı.
Ödeme araçları bölümünde yapılandırılmış bir API.
Aşağıdaki API izinleri:
- İşlem yapma → Kripto ödemeleri kabul et — kripto faturaları oluşturmak için.
- İşlem bulma — ödeme siparişlerini almak için.
Adını sciName olarak iletebileceğiniz bir Hosted Checkout yapılandırması.

API'nizi ve Hosted Checkout'u oluşturmak ve yapılandırmak için Ödeme ağ geçidi oluşturma sayfasına bakın.

Güncel sciName gereksinimi

GET /api/orders uç noktasının mevcut uygulaması, bir siparişi almak için Hosted Checkout adını (sciName) gerektirir.

Bu gereksinim kaldırılana kadar bir Hosted Checkout yapılandırması oluşturun ve izlemeniz gereken kripto faturalarını oluştururken adını sciName olarak iletin.

Müşterileri Hosted Checkout sayfasına yönlendirmeniz gerekmez. Yapılandırma yalnızca gerekli sciName değerini ve isteğe bağlı olarak Status URL bildirimlerini sağlamak için kullanılabilir.

Kimlik doğrulama

Merchant API istekleri kimlik doğrulama başlıkları gerektirir.

Her API isteğine şu başlıkları ekleyin:

Başlık	Açıklama
`Api-Name`	Volet.com hesabınızda yapılandırılan API adı.
`Account-Email`	API'nin ait olduğu Volet.com hesabının e-posta adresi.
`Authentication-Token`	`password:YYYYMMDD:HH` (UTC) değerinden oluşturulan SHA-256 token'ı; buradaki parola, Volet.com hesabınızda Ödeme araçları bölümünde belirlenir.

Örneğin:

SHA256("MySecret123:20261026:14")

şu sonucu verir:

c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd

Token değeri her UTC saatinde değişir. Önceki saatte oluşturulmuş bir token'ı yeniden kullanmamak için her istekten hemen önce yeni bir token oluşturun.

API'ye yalnızca oluşturulan token gönderilir. API parolanızı asla göndermeyin.

API parolanızı gizli tutun. API kimlik bilgilerini veya kimlik doğrulama token'larını ön uç kodunda, mobil uygulamalarda, botlarda veya istemci tarafı betiklerde asla açığa çıkarmayın.

Kimliği doğrulanmış örnek istek:

curl -X POST https://api.volet.com/api/invoice/crypto-invoice/deposit \
  -H "Content-Type: application/json" \
  -H "Api-Name: my-store-api" \
  -H "Account-Email: [email protected]" \
  -H "Authentication-Token: c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd" \
  -d '{
    "receiverCurrency": "USD",
    "senderCurrency": "USDT_TRC20",
    "amount": 100,
    "transferAction": "GET",
    "sciName": "Store",
    "orderId": "ORDER-1001"
  }'

Yalnızca API ödeme akışı

Tüm kripto ödeme deneyimini uygulamanız yönetiyorsa bu akışı kullanın.

Sisteminizde bir sipariş oluşturun.
İsteğe bağlı olarak hesaplanan fatura bilgilerini kontrol edin.
API üzerinden bir kripto faturası oluşturun.
Müşteriye ödeme adresini, tutarı, para birimini, ağı ve son geçerlilik süresini gösterin.
Müşteri ödemeyi bir kripto cüzdandan gönderir.
Ödemeyi GET /api/orders, Status URL bildirimleri veya her ikisiyle izleyin.
Ödeme tamamlandığında sisteminizdeki sipariş durumunu güncelleyin.

Adım 1 (isteğe bağlı): Fatura bilgilerini kontrol edin

Fatura oluşturmadan önce hesaplanan fatura değerlerini kontrol edebilirsiniz.

Bu adımla asıl faturayı oluşturmadan önce gönderen tutarını, alıcı tutarını, döviz dönüştürmeyi ve son geçerlilik süresini önizleyebilirsiniz.

Uç nokta:

POST /api/invoice/crypto-invoice/check

API referansında Kripto fatura kontrolü sayfasına bakın.

Örnek istek:

{
  "receiverCurrency": "USD",
  "senderCurrency": "USDT_TRC20",
  "amount": 100,
  "transferAction": "GET",
  "note": "Order #1001",
  "sciName": "Store",
  "orderId": "ORDER-1001",
  "subMerchantURL": "https://merchant.example.com"
}

Örnek yanıt:

{
  "receiverCurrency": "USD",
  "senderCurrency": "USDT_TRC20",
  "amount": 100,
  "transferAction": "GET",
  "note": "Order #1001",
  "sciName": "Store",
  "orderId": "ORDER-1001",
  "subMerchantURL": "https://merchant.example.com",
  "senderAmount": 100,
  "receiverAmount": 100,
  "expirationDate": "2026-01-15T10:30:00",
  "expirationDateMillis": 1768473000000
}

Bu adım ödeme adresi oluşturmaz ve ödemeyi başlatmaz.

Adım 2: Kripto faturası oluşturun

Müşteri ödemeye hazır olduğunda bir kripto faturası oluşturun.

Uç nokta:

POST /api/invoice/crypto-invoice/deposit

API referansında Para yatırma kripto faturası oluşturma sayfasına bakın.

Örnek istek:

{
  "receiverCurrency": "USD",
  "senderCurrency": "USDT_TRC20",
  "amount": 100,
  "transferAction": "GET",
  "note": "Order #1001",
  "sciName": "Store",
  "orderId": "ORDER-1001",
  "subMerchantURL": "https://merchant.example.com"
}

Yanıt, uygulamanızın müşteriye göstermesi gereken ödeme bilgilerini döndürür.

Örnek yanıt:

{
  "receiverCurrency": "USD",
  "senderCurrency": "USDT_TRC20",
  "amount": 100,
  "transferAction": "GET",
  "note": "Order #1001",
  "sciName": "Store",
  "orderId": "ORDER-1001",
  "subMerchantURL": "https://merchant.example.com",
  "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "addressOldFormat": null,
  "destinationTag": null,
  "senderAmount": 100,
  "receiverAmount": 100,
  "expirationDate": "2026-01-15T10:30:00",
  "expirationDateMillis": 1768473000000
}

Bu örneklerdeki tutarlar temsilidir. Gerçek senderAmount ve receiverAmount değerleri seçilen para birimlerine, döviz kuruna ve geçerli komisyonlara bağlıdır.

Fatura isteği alanları

Alan	Zorunlu	Açıklama
`receiverCurrency`	Evet	Ödeme tamamlandıktan sonra Volet.com hesabınıza yatırılan para birimi. Desteklenen değerler için API referansına bakın.
`senderCurrency`	Evet	Müşterinin ödeme için kullanması gereken para birimi ve ağ, örneğin `USDT_TRC20`.
`amount`	Evet	Ödeme tutarı. Nasıl yorumlanacağı `transferAction` değerine bağlıdır.
`transferAction`	Evet	`amount` değerinin hangi tarafa ait olduğunu belirler. Olası değerler: `GIVE`, `GET`. Bkz. `GIVE` ve `GET`.
`note`	Hayır	Ödeme notu veya sipariş açıklaması. En fazla 255 karakter.
`sciName`	Hayır*	Volet.com hesabınızda belirlenen Hosted Checkout adı. Siparişi `GET /api/orders` ile almak veya Hosted Checkout yapılandırması üzerinden Status URL bildirimleri almak istiyorsanız şu anda zorunludur.
`orderId`	Hayır*	Dahili sipariş kimliğiniz, en fazla 64 karakter. Ödemeyi daha sonra `GET /api/orders` ile almak için gereklidir. Her ödeme için benzersiz bir değer kullanın.
`subMerchantURL`	Hayır	Ödeme başka bir üye işyeri adına işleniyorsa alt üye işyerinin web sitesi URL'si. Bkz. Alt üye işyerleri.

* Fatura oluşturma uç noktası bu alanı isteğe bağlı olarak kabul edebilir, ancak bu kılavuzda açıklanan izleme akışları için zorunludur.

`GIVE` ve `GET`

transferAction, istekteki amount değerinin hangi para biriminde ifade edildiğini belirler.

Değer	`amount` anlamı
`GIVE`	Müşterinin gönderdiği tutar, `senderCurrency` cinsinden.
`GET`	Volet.com hesabınıza yatırılacak tutar, `receiverCurrency` cinsinden.

API'nin döndürdüğü nihai senderAmount ve receiverAmount değerleri döviz kurları ve geçerli komisyonlar nedeniyle farklı olabilir.

Para birimi kodları

Bazı kripto para kodları, alt çizgiden sonra blokzincir ağını içerir.

Örneğin:

USDT_TRC20 — Tron üzerinde USDT.
USDT_ERC20 — Ethereum üzerinde USDT.
USDC_SOL — Solana üzerinde USDC.

Diğer varlıklar BTC, ETH veya TON gibi tek bir para birimi kodu kullanır.

Kabul edilen değerler için Desteklenen para birimleri ve token'lar sayfasına ve API referansına bakın.

Fatura yanıtı alanları

Alan	Açıklama
`address`	Müşterinin ödemeyi göndermesi gereken kripto adresi.
`addressOldFormat`	Seçilen ağda varsa alternatif adres biçimi.
`destinationTag`	Bazı ağların gerektirdiği hedef etiketi, memo veya ek tanımlayıcı.
`senderAmount`	Müşterinin göndermesi gereken tutar.
`senderCurrency`	Müşterinin kullanması gereken para birimi ve ağ.
`receiverAmount`	Hesabınıza yatırılması beklenen tutar.
`receiverCurrency`	Hesabınıza yatırılması beklenen para birimi.
`expirationDate`	Faturanın son geçerlilik tarihi ve saati.
`expirationDateMillis`	Faturanın milisaniye cinsinden Unix zaman damgası olarak son geçerlilik zamanı.

senderAmount, senderCurrency, address ve döndürülmüşse destinationTag değerlerini her zaman aynen gösterin.

Faturanın son geçerlilik zamanını hesaplamak ve göstermek için expirationDateMillis değerini kullanın.

Adım 3: Ödeme talimatlarını gösterin

Yalnızca API modunda ödeme talimatlarını müşteriye göstermekten uygulamanız sorumludur.

En azından şunları gösterin:

Gönderilecek tutar.
Para birimi ve blokzincir ağı.
Kripto adresi.
Gerekiyorsa hedef etiketi veya memo.
Son geçerlilik süresi.
Fonların yalnızca seçilen ağ üzerinden gönderilmesi gerektiğine dair uyarı.

Örnek:

Send exactly 100 USDT on Tron (TRC-20) to:

TXXXXXXXXXXXXXXXXXXXXXXXXXXXX

This invoice expires at 2026-01-15 10:30 UTC.

Do not send funds on another network.

Hedef etiketi veya memo gerektiren ağlarda bunu adresin yanında açıkça gösterin.

Adım 4: Ödeme durumunu kontrol edin

Fatura oluşturulduktan sonra arka ucunuz ödeme siparişini API üzerinden alabilir.

Uç nokta:

GET /api/orders

API referansında Ödeme siparişi sorgulama sayfasına bakın.

Güncel sorgu parametreleri:

Parametre	Zorunlu	Açıklama
`orderId`	Evet	Üye işyerinin sipariş tanımlayıcısı, en fazla 64 karakter.
`sciName`	Evet*	Faturayla ilişkili Hosted Checkout adı.

* sciName, sipariş alınırken şu anda API uygulaması tarafından zorunlu tutulur.

Örnek istek:

GET /api/orders?orderId=ORDER-1001&sciName=Store

Geçici sciName çözümü

Şu anda API ile oluşturulan bir sipariş yalnızca orderId ile güvenilir şekilde alınamaz.

Bir Hosted Checkout yapılandırması oluşturun, kripto faturasını oluştururken adını sciName olarak kullanın ve aynı değeri GET /api/orders isteğine iletin.

Bu çözümü müşteriye Hosted Checkout sayfasını göstermeden kullanabilirsiniz.

Örnek yanıt:

{
  "orderId": "ORDER-1001",
  "sciName": "Store",
  "paymentStatus": "PENDING",
  "paymentMethod": "CRYPTO_INVOICE",
  "paymentCreated": "2026-01-15T10:00:00",
  "transaction": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "PENDING",
    "senderAmount": 100,
    "senderCurrency": "USDT_TRC20",
    "receiverAmount": 100,
    "receiverCurrency": "USD",
    "created": "2026-01-15T10:00:00"
  },
  "invoice": {
    "created": "2026-01-15T10:00:00",
    "received": "2026-01-15T10:12:00",
    "invoiceStatus": "RECEIVED",
    "externalStatus": "PAYMENT_RECEIVED",
    "penalties": [],
    "cryptoCurrencyAddress": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "initialSenderAmount": 100,
    "actualReceivedAmount": 100,
    "senderCurrency": "USDT_TRC20",
    "cryptoCurrencyTransactionId": "11111111-1111-4111-8111-111111111111"
  }
}

Eşleşen sipariş bulunamazsa API 404 döndürebilir. Aynı sipariş için yeni bir fatura oluşturmadan önce orderId ve sciName değerlerini kontrol edin.

Ödeme durumu

Ödemenin tamamlanıp tamamlanmadığını belirlemek için üst düzeydeki paymentStatus değerini kullanın.

Durum	Anlamı	Önerilen işlem
`PENDING`	Ödeme henüz nihai tamamlanmış duruma ulaşmadı.	Siparişi beklemede tutun.
`COMPLETED`	Ödeme başarıyla tamamlandı.	Siparişi ödendi olarak işaretleyin ve ürünü veya hizmeti teslim edin.
`CANCELED`	Ödeme iptal edildi.	Siparişi teslim etmeyin.
`REFUNDED`	Ödeme iade edildi.	Siparişi iade sürecinize göre güncelleyin.

Bir siparişi yalnızca paymentStatus değeri COMPLETED olduğunda ödenmiş sayın.

Yanıt ayrıca invoiceStatus, externalStatus ve penalties gibi faturaya özgü alanlar içerir. Bunlar kripto faturası hakkında ek bilgi sağlayabilir.

Nihai sipariş durumunu belgelenmemiş externalStatus veya penalties değerlerinden çıkarmayın. Bunları yalnızca entegrasyonunuz API'nin döndürdüğü değerleri açıkça işliyorsa kullanın.

cryptoCurrencyTransactionId, API'nin döndürdüğü kripto işlem tanımlayıcısıdır. Seçilen ödeme akışı için doğrulanmadıkça bunun bir blokzincir işlem hash'i olduğunu varsaymayın.

Status URL bildirimlerini alma

API ile oluşturulan kripto faturalarını izlemenin tek yolu GET /api/orders sorgulaması değildir.

Volet.com hesabınızdaki API yapılandırmasında şu anda webhook URL'leri için alan bulunmuyor. Ancak API ile oluşturulan faturaların ödeme durumu bildirimlerini almak için bir Hosted Checkout ağ geçidinde yapılandırılan Status URL'yi kullanabilirsiniz.

Bu akışta müşterilere Hosted Checkout'u göstermeniz veya onları oraya yönlendirmeniz gerekmez.

Status URL bildirimlerini ayarlama

Volet.com hesabınızda bir Hosted Checkout yapılandırması oluşturun.
Yapılandırmanın Status URL alanını ayarlayın ve gerekli HTTP yöntemini seçin.
API üzerinden kripto faturaları oluştururken Hosted Checkout adını sciName olarak kullanın.
Müşteriye yönelik ödeme akışını kendi uygulamanızda tutun.
Ödeme durumu değiştiğinde Volet.com, bu Hosted Checkout için yapılandırılan Status URL'ye bildirim gönderir.
Sisteminizdeki siparişi güncellemeden önce bildirimin imzasını doğrulayın.
Gerektiğinde GET /api/orders isteğini mutabakat veya yedek kontrol olarak kullanın.

Örnek fatura isteği:

{
  "receiverCurrency": "USD",
  "senderCurrency": "USDT_TRC20",
  "amount": 100,
  "transferAction": "GET",
  "note": "Order #1001",
  "sciName": "Store",
  "orderId": "ORDER-1001"
}

Bu örnekte Store, Status URL'yi içeren Hosted Checkout yapılandırmasının adıdır.

Müşteri yine kendi ödeme arayüzünüzü görür. Hosted Checkout ödeme sayfası açılmaz.

not

Bu nedenle yalnızca API entegrasyonunda aynı sciName iki amaca hizmet eder:

GET /api/orders uç noktasının mevcut uygulamasının siparişi bulmasını sağlar.
API ile oluşturulan faturayı, Status URL bildirimleri için kullanılan Hosted Checkout yapılandırmasına bağlar.

Bildirim parametreleri ve imza doğrulaması için Hosted Checkout entegrasyonu sayfasına bakın.

Sorgulama ve Status URL bildirimleri

Şunlardan birini kullanabilirsiniz:

API ile sorgulama.
Status URL bildirimleri.
Her ikisi birlikte.

Status URL bildirimlerini kullanan entegrasyonlarda, bir bildirim geciktiğinde veya uç noktanız geçici olarak erişilemez olduğunda API ile sorgulama mutabakat için faydalıdır.

Yalnızca bir durum isteği veya bildirim iletimi başarısız oldu diye yinelenen fatura oluşturmayın.

API + Hosted Checkout akışı

Müşteriye yönelik ödeme sayfasını Hosted Checkout'un kendisinin sağlamasını, arka ucunuzun ise takip ve mutabakat için API'yi kullanmasını istiyorsanız bu modeli kullanın.

Ödeme akışı:

Sisteminizde bir sipariş oluşturun.
Hosted Checkout entegrasyonunuzla müşteriyi Hosted Checkout'a yönlendirin.
orderId değerinizi Hosted Checkout ödeme talebinde iletin.
Müşteri ödemeyi Hosted Checkout sayfasında tamamlar.
Volet.com, Status URL'nize ödeme durumu bildirimi gönderir.
Arka ucunuz bildirimin imzasını doğrular.
Arka ucunuz sipariş durumunu günceller.
İsteğe bağlı olarak arka ucunuz mutabakat için siparişi API üzerinden kontrol eder.

Bu modelde Hosted Checkout şunları yönetir:

Ödeme sayfası.
Ödeme yöntemi seçimi.
Ödeme talimatları.
Müşteri yönlendirmeleri.

API, ödeme siparişini orderId ve sciName ile almak ve durumu sisteminizde mutabakata bağlamak için yine kullanılabilir.

Hosted Checkout ile durumun işlenmesi

Hosted Checkout sayfasını kullanırken yalnızca Success URL veya Failed URL yönlendirmelerine güvenmeyin.

Müşteri yönlendirmeleri tarayıcı akışının parçasıdır ve sunucunuza her zaman ulaşmayabilir.

Arka uçtaki siparişi güncellemek için Status URL bildirimini, gerektiğinde mutabakat için de API ile sipariş sorgulamayı kullanın.

Önerilen yaklaşım:

Hosted Checkout Status URL bildirimini alın.
Bildirimin imzasını doğrulayın.
Bildirim geçerliyse siparişi güncelleyin.
GET /api/orders isteğini yedek veya mutabakat kontrolü olarak kullanın.

Bildirim içeriği ve imza doğrulama kuralları için Hosted Checkout entegrasyonu sayfasına bakın.

Hata işleme

Merchant API hataları, data.errors içinde bir veya daha fazla hata bulunan yapılandırılmış bir yanıt kullanır.

Örnek yapı:

{
  "status": "error",
  "data": {
    "errors": [
      {
        "errorMessage": "resourceNotFound",
        "errorType": "GENERAL",
        "errorId": "3f69d9b6",
        "errorDescription": "Resource not found",
        "errorField": null,
        "params": [],
        "requestParams": {}
      }
    ]
  }
}

Hata alanları:

Alan	Açıklama
`errorMessage`	API'nin döndürdüğü makine tarafından okunabilir hata kodu.
`errorType`	Hata kategorisi.
`errorId`	Kayıtlara ve destek taleplerine eklenebilecek hata tanımlayıcısı.
`errorDescription`	İnsan tarafından okunabilir hata açıklaması.
`errorField`	Varsa hatayla ilgili istek alanı.
`params`	Varsa hatayla ilişkili ek parametreler.
`requestParams`	Varsa hatayla ilişkili istek parametreleri.

Yaygın HTTP yanıtları:

HTTP durumu	Anlamı
`400`	İstek hatalı biçimlendirilmiş veya geçersiz parametreler içeriyor.
`401`	Kimlik doğrulama başlıkları eksik veya geçersiz.
`404`	İstenen kaynak bulunamadı.
`500`	Beklenmedik sunucu hatası.

Kesin errorMessage değerleri uç noktaya ve hataya bağlıdır. Uygulama hata kodunu yalnızca HTTP durumundan türetmeyin.

Hata oluştuğunda:

Destek ve teşhis için errorId değerini kaydedin.
Varsa errorField değerini kontrol edin.
Programatik hata işlemede errorDescription yerine errorMessage kullanın.
Sonucu belirsiz bir istek hatasından sonra otomatik olarak yinelenen fatura oluşturmayın.
Yalnızca güvenli olduğunda yeniden deneyin.

Test ve sandbox

Volet.com şu anda entegrasyon testi için sandbox veya hazırlık (staging) ortamı sunmuyor.

Hosted Checkout kullanıyorsanız müşteriye yönelik ödeme sayfasını geliştiriciler için Hosted Checkout sayfasında önizleyebilirsiniz. Önizleme bir sandbox değildir ve entegrasyon testinin yerini tutmaz.

Canlıya geçmeden önce API, Hosted Checkout ve ödeme akışının tanıtımı için Volet.com satış ekibiyle iletişime geçin.

Test kontrol listesi

Gerçek kripto ödemeleri kabul etmeden önce entegrasyonunuzun kullandığı tüm akışı doğrulayın.

Yalnızca API entegrasyonları için:

Kullanılıyorsa fatura kontrolü.
Fatura oluşturma.
Ödeme adresinin doğru gösterilmesi.
Gerektiğinde hedef etiketinin veya memonun gösterilmesi.
Para biriminin ve ağın doğru gösterilmesi.
Fatura süresinin dolmasının işlenmesi.
orderId ve sciName değerlerinin saklanması.
GET /api/orders ile sipariş sorgulama.
Tamamlanan ödemelerin işlenmesi.
İptal edilen ve iade edilen ödemelerin işlenmesi.
Yinelenen orderId değerlerinin işlenmesi.
API hatalarının işlenmesi.

Status URL bildirimlerini kullanıyorsanız:

Hosted Checkout yapılandırması doğru Status URL'yi içeriyor.
Aynı Hosted Checkout adı sciName olarak iletiliyor.
Bildirimler arka ucunuza ulaşıyor.
Bildirim imzaları doğrulanıyor.
Yinelenen bildirimler güvenli şekilde işleniyor.
Mutabakat için API ile sorgulama kullanılabiliyor.

Hosted Checkout ödeme sayfasını kullanıyorsanız ayrıca şunları doğrulayın:

Müşterinin Hosted Checkout'a yönlendirilmesi.
Success URL yönlendirmesi.
Failed URL yönlendirmesi.
Status URL bildirimlerinin iletilmesi.
Bildirim imzasının doğrulanması.
Mutabakat için API ile sipariş sorgulama.

Önemli notlar

Yalnızca API entegrasyonlarında müşterilerin Hosted Checkout'u ziyaret etmesi gerekmez.
Mevcut sipariş sorgulama akışı sciName gerektirir.
Bir Hosted Checkout yapılandırması, Hosted Checkout sayfası gösterilmeden yalnızca sciName ve Status URL bildirimleri için kullanılabilir.
Her ödeme için her zaman benzersiz bir orderId kullanın.
API'nin döndürdüğü adresi, tutarı, para birimini, ağı ve hedef etiketini her zaman aynen gösterin.
paymentStatus değeri COMPLETED olana kadar siparişi ödendi olarak işaretlemeyin.
Faturanın son geçerlilik zamanını hesaplarken expirationDateMillis değerini kullanın.
Kripto ödemeler blokzincir onaylarına ve ağ koşullarına bağlıdır.
Fonları yanlış adrese veya ağa göndermek fonların kalıcı olarak kaybedilmesine yol açabilir.
Sonucu belirsiz bir zaman aşımından veya geçici bir API hatasından sonra otomatik olarak yeni fatura oluşturmayın.

Ödeme ağ geçidi oluşturma — API'yi ve Hosted Checkout'u oluşturun ve yapılandırın
Emanetçi kripto ödemeleri kabul etme — emanetçi kripto ödemeler nasıl çalışır
Hosted Checkout entegrasyonu — barındırılan ödeme sayfasını ve Status URL bildirimlerini kullanın
Desteklenen para birimleri ve token'lar — desteklenen para birimleri ve ağlar
API referansı — yöntemler, parametreler ve yanıtlarla ilgili eksiksiz dokümantasyon

API entegrasyonu ne zaman kullanılır​

Entegrasyon modelleri​

Başlamadan önce​

Kimlik doğrulama​

Yalnızca API ödeme akışı​

Adım 1 (isteğe bağlı): Fatura bilgilerini kontrol edin​

Adım 2: Kripto faturası oluşturun​

Fatura isteği alanları​

GIVE ve GET​

Para birimi kodları​

Fatura yanıtı alanları​

Adım 3: Ödeme talimatlarını gösterin​

Adım 4: Ödeme durumunu kontrol edin​

Ödeme durumu​

Status URL bildirimlerini alma​

Status URL bildirimlerini ayarlama​

Sorgulama ve Status URL bildirimleri​

API + Hosted Checkout akışı​

Hosted Checkout ile durumun işlenmesi​

Hata işleme​

Test ve sandbox​

Test kontrol listesi​

Önemli notlar​

İlgili sayfalar​

API entegrasyonu ne zaman kullanılır

Entegrasyon modelleri

Başlamadan önce

Kimlik doğrulama

Yalnızca API ödeme akışı

Adım 1 (isteğe bağlı): Fatura bilgilerini kontrol edin

Adım 2: Kripto faturası oluşturun

Fatura isteği alanları

`GIVE` ve `GET`

Para birimi kodları

Fatura yanıtı alanları

Adım 3: Ödeme talimatlarını gösterin

Adım 4: Ödeme durumunu kontrol edin

Ödeme durumu

Status URL bildirimlerini alma

Status URL bildirimlerini ayarlama

Sorgulama ve Status URL bildirimleri

API + Hosted Checkout akışı

Hosted Checkout ile durumun işlenmesi

Hata işleme

Test ve sandbox

Test kontrol listesi

Önemli notlar

İlgili sayfalar