Hizmetinizle Entegrasyon

Tüccar

Sipariş Oluştur

Yöntemi Kullanın public/exchanger/order/create

Adı	Açıklama	Tür
routeId	Yönlendirme ID	ObjectID
partner	Ortak kodu	STRING
amount	tutar	FLOAT
fromValues[0][key]	alan anahtarı	ObjectID
fromValues[0][value]	alan değeri	STRING
toValues[0][key]	alan anahtarı	STRING
toValues[0][value]	alan değeri	STRING
routeValues[0][key]	alan anahtarı	ObjectID
routeValues[0][value]	alan değeri	STRING
lang	dil (ukr, eng)	STRING
agreement	anlaşma	BOOLEAN
hideOutData	Hesap bilgilerini gizle	BOOLEAN
clientCallbackUrl	Uygulama tamamlandığında, müşteri siteye dönüş yapabilecek bir buton görecektir ve müşteri bu URL'ye yönlendirilecektir. ?status=success veya ?status=error	STRING
ipnUrl	Anında ödeme bildirim URL'si (Sipariş durumu değiştiğinde tetiklenecektir)	STRING
ipnSecret	ipn URL'sinde güvenli bir hash oluşturmak için dize	STRING

Yetkilendirme sistemi belgelerini kullanıcı panelinizde bulabilirsiniz. Yöntemlerle ilgili daha fazla bilgi ve ek verileri şu adreste bulabilirsiniz:

IPN (Ödeme talebi durumu değişikliği bildirimi)

Sipariş oluşturulduğunda durum değişikliği bildirimi almak için ek parametreler göndermeniz gerekmektedir:

clientCallbackUrl - Uygulama tamamlandığında, müşteri siteye dönüş yapabilecek bir buton görecektir ve müşteri bu URL'ye yönlendirilecektir.
hideOutData - Alıcı verilerini gizle
ipnUrl - Sunucunuza bildirim göndermek için HTTP / HTTPS URL'si.
ipnSecret - Talep imzası oluşturmak için rastgele bir dize (talep bütünlüğünü sağlamak için)

Talep POST yöntemiyle gönderilecektir
IPN bir kez gönderilecektir
IPN teslimi garanti edilmez (sunucu isteği yanıtlamazsa, tekrar gönderilmeyecektir)

IPN Örneği

POST
['Content-Type'] = 'application/x-www-form-urlencoded'

orderUID :Number() - sipariş uid
orderId :String(ObjectId) -sipariş id
newStatus :String() - sipariş mevcut durum
inAmount :String(number) - order in sum
outAmount :String(number) - order out sum
xml_from :String() - sipariş uid
xml_to :String() - sipariş uid
timestamp :Number() - Unix zamanı ve IPN bildirimi
toValues :Array([{key,name,value}]) - sipariş bilgileri

Durumlar listesi

new - yeni sipariş
waitPayment - Kullanıcıdan ödeme bekleniyor
errorPayment - Kullanıcı ödeme hatası (satıcı gönderim hatası)
inProgress - işlemde (admin tarafından işlenmesi veya ödeme bekleniyor)
inProgressPayout - Ödeme kuyruğunda (ödeme başarıyla alındı) (otomatik ödeme ayarlanmışsa, ödeme başlatılacaktır)
errorPayout - Ödeme hatası (ödeme sırasında bir hata oluştu)
hold - sipariş askıya alındı (uygulama problemi)
done - sipariş başarıyla ödendi
returned - sipariş ödendi, ancak takas ve geri ödeme koşulları tamamlanmadı
deleted - sipariş silindi (iptal edildi)

IPN talep kontrolü

sha256(orderId:newStatus:inAmount:outAmount:xml_from:xml_to:timestamp:ipnSecret)

        
const stringForHash = orderId+":"+newStatus+":"+inAmount+":"+outAmount+":"+xml_from+":"+xml_to+":"+timestamp+":"+ipnSecret;
// example string for hash 5d8e6002b80b7b4cd75a6424:inProgress:2:317.42:ETH:WMZ:1571328406072:SECRET123

const hash = crypto.createHash('sha256').update(stringForHash).digest('hex')
// example hash af3acf947e6f0e0f2c267e300b8582e504dba12d1f2d058652b7414163c09f48

Ödeme kontrolü

Eğer taleplerin durumunu kontrol etmek, yetkilendirme ile oluşturmak istiyorsanız, tüm talepler kullanıcı panelinizde görünecektir;
UID talebini ve gizliyi saklayabilir ve manuel olarak talebe bu verileri adres çubuğunda girerek geçiş yapabilirsiniz

Ödeme

/payment/ ile ödeme sayfasını görüntüleyebilirsiniz

// schema https://www.coinpointr.com/user-lang/payment/order-uid/order-secret // example result https://www.coinpointr.com/en/payment/1409/dGqwF2M2eBPaSN1G5ljMS1cb
Ayrıca, sadece borsaya olan bağlantıyı verebilirsiniz, tüm müşteriler tarafından görülen aynı şemada, sadece /payment/ kısmı /order/ ile değiştirilecektir
Yöntemde, ödeme verilerini veya ödeme formunu sitenizde görüntülemenizi sağlayan parametreler bulunmaktadır. ÖNEMLİ: Eğer ön ödeme yöntemini kullanıyorsanız, ödeme yapıldıktan sonra sipariş durumunu waitPayment'den inProgress'e güncellemeniz gerekmektedir.