Moove API
Tek çağrı. Tam ödeme.
Kodunuzdan bir ödeme bağlantısı oluşturun. Müşteriniz istediği token ile öder, siz de tutarın tamamını kendi token’ınızla alırsınız.
Anahtardan ilk ödemeye.
API anahtarı oluşturun
Moove Business’ta Moove Receive Agent için bir anahtar oluşturun. Yalnızca bir kez gösterilir; doğrudan ortam değişkenlerinize ekleyin.Ödeme bağlantısı oluşturun
Tek bir POST, bir ödeme URL’si döndürür. Müşteriniz orada, herhangi bir zincirde, herhangi bir token ile öder.Ödendiğinde haberdar olun
Bir HTTPS uç noktası kaydedin; bir bağlantı ödendiği anda Moove oraya imzalı bir olay gönderir.
Küçük API. Sağlam garantiler.
Her token ile ödeme, kendi token’ınızla tahsilat
Müşteriler ellerindeki varlıkla, 30+ blokzincir ağında öder. Her ödeme, seçtiğiniz token ve zincirde cüzdanınıza aktarılır.Üzerine inşa edebileceğiniz bir sözleşme
URL yolunda sürümlenir, v1’de yalnızca ekleme yapılır ve canlı bir OpenAPI şeması sunar.Net limitler, net hatalar
Anahtar ve IP başına limitler, sade bir 429 ve sabit kodlu tek bir hata biçimi.API’nin kendisi ücretsiz.
Abonelik yok, çağrı başına ücret yok. Başka bir token veya zincirle ödeyen müşteri %0,02’yi karşılar; böylece tutarın tamamını alırsınız.- API erişimi
- Ücretsiz
- Aynı token, aynı ağ
- Ücretsiz
- Tokenlar veya ağlar arası
- %0,02
Moove ya da sıfırdan geliştirmek.
| Moove ya da sıfırdan geliştirmek. | Moove | Şirket içi geliştirme |
|---|---|---|
| Desteklenen zincirler | Moove: Tek uç noktadan 30+ | Şirket içi geliştirme: Her zincir için ayrı entegrasyon |
| Token’ınıza dönüştürme | Moove: Her ödemeye dahil | Şirket içi geliştirme: Kendi swap ve bridge yönlendirmeniz |
| Ödemenin ulaştığını bilmek | Moove: İmzalı webhook’lar ve bir listeleme uç noktası | Şirket içi geliştirme: Her zincir için çalıştırdığınız dinleyiciler |
| Ödeme sayfası | Moove: Paylaşıma hazır, barındırılan bir bağlantı | Şirket içi geliştirme: Tasarımı, geliştirmesi ve barındırması size ait |
| Bir anahtar sızarsa | Moove: Yalnızca size ödeme talep edebilir | Şirket içi geliştirme: Sıcak cüzdandaki her şey |
Sık sorulan sorular.
API anahtarını nasıl alırım?
Moove Business konsolunda oturum açın ve API anahtarları bölümünü açın. Anahtara bir ad verin ve ödeme bağlantıları oluşturma ve okuma izni veren Moove Receive Agent’ı seçin. Anahtarın tamamı yalnızca bir kez, oluşturulurken gösterilir ve bir daha gösterilmez; bu yüzden bir gizli anahtar yöneticisinde saklayın. Anahtar oluşturan bir uç nokta yoktur; bu nedenle bir anahtar asla başka bir anahtar üretemez.
Müşteri ödediğinde para nereye gider?
Anahtar sahibinin varsayılan cüzdanına, o cüzdanın zincirinde ve tahsilat token’ında gider. Çağrıyı yapan taraf başka bir hedef belirleyemez. Bu yüzden ilk çağrıdan önce hesabın alınmış bir Moove handle’ı ve tahsilat token’ı tanımlı varsayılan bir cüzdanı olmalıdır; ikisinden biri eksikse bağlantı oluşturma isteği, hesabın ödeme almaya hazır olmadığını belirten bir 409 döndürür.
Ödeme gönderme API’si var mı?
Henüz yok. API ödeme alır, ödeme göndermez. Bugün tedarikçilere veya yüklenicilere ödeme yapmak için Moove Business konsolundaki Gönder özelliğini kullanın. Bir Moove Send Agent duyuruldu; kullanıma sunulduğunda belgelerde yer alacak.
Moove webhook’ları nasıl çalışır?
Konsolda en fazla beş HTTPS uç noktası kaydedin. Her biri iki olay alır: biri bir bağlantıya yapılan ödeme hesaba geçtiğinde, diğeri bağlantı tamamlandığında. Gönderimler, yalnızca bir kez gösterilen bir gizli anahtarla HMAC-SHA256 kullanılarak imzalanır. Teslimat en az bir kez yapılır; bu yüzden yinelenenleri olay kimliğine göre ayıklayın. Başarısız bir teslimat en fazla altı kez yeniden denenir.
İstek sınırları var mı?
Evet. İstekler API anahtarı ve kaynak IP başına sınırlandırılır; hangisine önce ulaşılırsa o geçerlidir ve sınırı aşmak 429 döndürür. Reddedilen istekler de sayıldığı için hemen yeniden denemek yerine biraz jitter ekleyerek üstel geri çekilme uygulayın. Ödeme durumu için tek bir bağlantıyı sürekli sorgulamak yerine webhook’ları kullanın ve birden fazla entegrasyon aynı sunucuyu paylaşıyorsa IP sınırını hesaba katın.
API nasıl sürümlenir?
URL yolunda. Bugün tek bir herkese açık sürüm var: v1. Bir sürüm içindeki değişiklikler yalnızca ekleme yapar: yeni uç noktalar, yeni isteğe bağlı alanlar, yeni yanıt alanları. Bir alanı kaldırmak veya bir türü değiştirmek gibi istemciyi bozabilecek her şey yeni bir yol sürümüyle yayınlanır. İstemcinizi bilinmeyen alanları yok sayacak ve mesajlara göre değil, her zaman hata kodlarına göre dallanacak şekilde kurun.
