Crypto Payments ile entegre MochiPay API

01 · Hazırlayın MochiPay Hesabı

1. Bir Hesap Oluşturmak ve Bir aboneliği etkinleştirin.
2. Açık Cüzdanlar, Add HD Wallet → Generate New seçeneğini seçin, güvenli bir şekilde kurtarma cümlesini yedekleyin ve cüzdanınızı kaydedin.
3. Müşteri yüzü tanıdık bir ekran adı ayarlayın Profil.
4. Açık API kimlik bilgileri Kopyalamak için API Anahtar ve Kurtarma API Gizli bir gizlilik yoksa, ilk kez kurulmak için yeniden yapılandırın ve güvenli bir şekilde saklayın. mevcut gizli bir gizli yeniden yapılandırmak, önceki gizli kullanan bütünleşmeleri bozulur.

Hazır olduğunda: aboneliğiniz ve cüzdanınızı almanız aktiftir ve aşağıda gerekli kimlik doğrulamalarınız vardır.

02 • Kurulumu ayarlayın PHP Demo

Download and extract the PHP Demo. Upload the entire extracted directory, including portable/ and its QR-code license, to a PHP 7.0–8.4 server with cURL, JSON, sessions, secure random generation, private writable temporary storage and HTTPS. Protect the demo form as an administrator/staging tool; use your durable order database for production. Edit the configuration at the top of order.php.

Açık : Server-side order.php configuration

ayarları	ne içeri girer
MOCHIPAY_BASE_URL	https://mochi.bz
MOCHIPAY_API_KEY	Senin tüccarın API Anahtar
MOCHIPAY_API_SECRET	Senin kurtarılan API Gizli
MOCHIPAY_CHECKOUT_MODE	ON_SITE (Devamı için tıklayınız) veya HPP
MOCHIPAY_DEMO_PUBLIC_URL	Senin mutlak HTTPS demo dizin URL, özellikle bir proxy arkasında

Tedarik edilen PHP Demo Kullanımı CURLOPT_SSL_VERIFYPEER => false CURL talepleri için. devamını oku API Sunucu tarafında sırlar konfigürasyon. asla bunları tarayıcıya koymayın JavaScript.

Hazır olduğunda: order.php loads without the credential or cURL configuration error.

Site seçeneği veya HPP

Checkout modu, bir entegrasyon tercihiniz değil, bir API alan. her iki bağlantı da bir sipariş kullanır. modları değiştirirken başka bir sipariş oluşturmayın. Classic SaaS destekler HPP Sadece

All five methods are available: USDT_TRC20, USDC_ERC20, BTC_BITCOIN, ETH_ERC20 and SOL_SOLANA. UP is the default unique amount direction; DOWN is also supported. Enable a receiving wallet for each offered method.

03 · Bir test siparişi yerine getirmek ve ödemek

Open order.php. Create a small demo order using a unique merchant order reference and a configured payment method. Select ON_SITE or HPP; open the preferred link shown after creation. The result also offers Embedded store checkout and PHP HPP redirect links; both are implemented in checkout.php. The alternative link uses the same order.

1. Seçilen varlık ve ağ ile eşleşir ve ödeme sayfasında gösterilen doğru miktarı gönderir.
2. Gönderen The Ödeme sayfasında tam miktar Gösterilen alıcı adresine. başka bir siparişten bir adresi yuvarlamayın veya yeniden kullanmayın.
3. İhtiyacınız olan Blockchain onaylarını bekleyin ve MochiPay Olmak için emir PAID.

The store/API example may price the product in USD. MochiPay locks the conversion when creating the order; unique amount adjustments can change the final payable amount. The checkout value is the amount to send.

Başarı kontrolü : Bu MochiPay Sipariş PAID'i gösterir, işlem kaydedilir. tarayıcı geri dönüş sayfasını yalnızca açmak ödemeyi kanıtlamaz.

04 · Sonuç ve portföy alımını kontrol edin

Query the order by the system order_id from your application. Accept payment only after the authenticated query is PAID and matches your stored system ID, merchant reference, original amount/currency, selected asset/network, receiving address, exact payable amount and expected received amount. Fulfill through an atomic, idempotent local transaction. callback.php demonstrates this verification for notifications and browser returns, using private demo records. It does not fulfill orders; replace temporary records and the callback TODO with your production database and fulfillment transaction. Read the bundled README.

Match the payment transaction and receiving address with your MochiPay order. Review the receiving wallet or blockchain explorer. Funds are already in your receiving wallet; there is no platform withdrawal request.

Uyumlu bir cüzdan kullanın ve para aktarırken blockchain onaylarını bekleyin. Read the receiving-wallet management rehberi →

İyileşme ve doğru miktar

Bu denemeden önce devam edin.Görüntüleri oluşturun. PHP Demo kurtarma request_id ve tam ödeme yükü oluşturmadan önce sipariş. bir sistem kimliği kaydedilmemiş bir zaman çıkmasından sonra, aynı ödeme yükünü geri alın ve request_id• Bilinen bir order_id Daha eski kayıtlar için istenmeyen request_id, herhangi bir yeni oluşturmadan önce benzersiz tüccar referansını sorgulayın. PHP veya JavaScript Float dönüştürme; gösterim pay_amount Tamam. - Birleşik QR Sadece adresi kodlayın, böylece müşteriler gösterilen miktarı girmelidir.

Kendi inşaatını yaparken API Müşteri

Kullanımı X-Mochi-Key ve X-Mochi-Signature• Doğru işareti işareti oluşturun JSON Temel kullanılarak64HMAC-SHA kodlanmış256Query Order, soru işareti olmadan doğru soru çubuğunu işaret eder.

Test tamamlanmamışsa

Seçmeli talep deduplikasyon

Mevcut bütünleşmeler olmadan çalışmaya devam ediyor. request_id• Bir zaman geçtikten sonra aynı ödeme siparişi tekrar kullanmak için, seçmeli bir ödeme eklemek request_id İmzalayanlara JSON Mevcut HMAC imzası hesaplamadan önce vücut.

{"merchant_order_id":"STORE-1001","amount":25,"currency":"USD","payment_method":"USDT_TRC20","request_id":"STORE-1001:create:v1"}

Use 1–64 ASCII letters, digits, dots, underscores, colons or hyphens. A key belongs to one merchant and one request payload. Reuse the same key and payload for retries; responses keep the existing fields and return the original order in its current state. Keys are retained without automatic expiry. For a genuinely new purchase, use a new key and a new merchant_order_id; an unpaid earlier purchase does not block the same amount on a different reference. WEB82.3 guards reference creation even without request_id. Query a legacy uncertain reference first; replay unchanged only after authenticated404 ORDER_NOT_FOUND with recovery_contract=merchant-reference-v1. Deploy the website API before recovery plugins.

HTTP 409 REQUEST_IN_PROGRESS: Retry-After gecikmesinden sonra aynı talep geri çekilir. HTTP 409 REQUEST_ID_CONFLICT: anahtar farklı bir ödeme yükü ile yeniden kullanılmıştır. yeni bir anahtar oluşturmayın sadece bir timeout geçmek için. ON_SITE ve HPP İkisi de geri ödeme alanlarını kullanabilir veya payment_url Daha önce olduğu gibi.