← Kaikki integraatio-oppaatYHDENTYMISOHJE · API / BACKEND / MOBILEIntegroida Crypto maksut MochiPay API
Luo ja tiedustele maksumääräyksiä sovelluksestasi. PHP Demo 1.2.0 tukee PHP 7.0–8.4 ja tarjoaa order.php, callback.php, checkout.php molemmat esityshaat, niputetut paikalliset dialogiresurssit ja englanninkielisen README. Käytä paikan päällä (oletus) tai HPP samalla maksumääräyksellä.
Demo kävelee läpi · havainnollisen konfiguraatio · käyttää pientä todellista maksua tarkistaa oman asetukset.
Maksuvirtakuva. Paikan päällä ja HPP käyttää samaa maksumääräystä; palvelin tarkistaa sen lopullisen tilan.Katso täydellinen maksutulos
Demokuva näytearvoilla. Varmista nämä tulokset käyttämällä todellista pientä maksua omassa setup; kassan määrä ja vahvistusvaatimukset riippuvat tilauksesta.
01 · Valmistele MochiPay tili
- Luo tili sekä aktivoi tilaus.
- Avaa Lompakot, valitse Lisää HD-lompakko → Luo uusi, turvallisesti varmuuskopio ja tallentaa lompakko. Ota käyttöön testissä käyttämäsi voimavara/verkko.
- Aseta tunnistettavissa oleva asiakaslähtöinen näyttönimi Profiili.
- Avaa API-valtuutukset ja kopioida API avain ja tallentaa API salaisuus. Jos salaisuutta ei tallenneta, uusi se ensimmäistä kertaa ja säilytä turvallisesti. Olemassa olevan salaisuuden uudistaminen mitätöi integraatiot, jotka käyttävät edellistä salaisuutta.
Valmis: tilata ja vastaanottaa lompakko ovat aktiivisia, ja sinulla on tarvittavat tiedot alla.
Katso kuvallisen tilin asetukset →Valitse paikan päällä tai HPP
| Tila | Asiakaskokemus | Palvelinvastuu |
|---|
| Paikalla (oletus) | Maksuikkuna omalla verkkoalueella, tarkka määrä, osoite, verkko, QR ja tila. | Luo ja tallenna maksu sitova; kysele oman taustaosan kautta ja palauta vain turvallinen maksunäkymä. |
|---|
| HPP | Uudelleenohjaa palautettuun payment_url-osoitteeseen MochiPay. | Tallenna sama sitova ja tarkista puhelut/palautteet palvelimelta palvelimelle. |
|---|
Checkout-tila on kotoutumisasetuksesi, ei API-kenttä. Molemmat linkit käyttävät yhtä tilausta. Älä luo toista järjestystä vaihdettaessa. Classic SaaS tukee vain HPP.
Kaikki kuusi menetelmää ovat käytettävissä: USDT_TRC20, USDC_ERC20, BTC_BITCOIN, ETH_ERC20, SOL_SOLANA ja TRX_TRON. YLÖS on oletusarvoinen yksilöllisen määrän suunta; DOWN on myös tuettu. Ota käyttöön vastaanottava lompakko jokaiselle tarjotulle menetelmälle.
03 · Aseta ja maksa testitilaus
Avaa order.php. Luo pieni esittelytilaus käyttämällä yksilöllistä kauppiastilausviittausta ja määritettyä maksutapaa. Valitse ON_SITE tai HPP; avaa haluamasi linkki, joka näkyy luomisen jälkeen. Tuloksessa on myös upotetut myymälän kassa- ja PHP HPP -uudelleenohjauslinkit; molemmat on toteutettu checkout.php:ssä. Vaihtoehtoinen linkki käyttää samaa järjestystä.
- Match valittu omaisuus ja verkko, ja lähettää tarkka määrä näkyy maksu sivulla.
- Lähetä tarkka määrä maksusivulla näytettyyn vastaanottoosoitteeseen. Älä kierrä tai käytä osoitetta uudelleen eri tilauksesta.
- Odota tarvittavia lohkoketju vahvistukset ja MochiPay tilauksen tulla
PAID.
Kauppa/API-esimerkki voi hinnoitella tuotteen USD:ssä. MochiPay lukitsee muuntaminen luotaessa tilauksen; ainutlaatuinen määrä korjaukset voivat muuttaa lopullisen maksettavan määrän. Kassan arvo on lähetettävä määrä.
Menestystarkistus: MochiPay-tilaus näyttää PAIDin, kun tapahtuma on kirjattu. Selaimen palautussivun avaaminen ei yksin todista maksua.
04 · Varmista tulos ja lompakon kuitti
Pyydä tilaus järjestelmästä order_id sovelluksestasi. Hyväksy maksu vasta, kun todennettu kysely on PAID ja vastaa tallennettua järjestelmätunnusta, kauppiaan viitettä, alkuperäistä summa/valuutta, valittua vara/verkko, vastaanottajaosoitetta, tarkkaa maksettavaa summaa ja odotettua vastaanotettua summaa. Toteuta atomimaisen, idempotentin paikallisen transaktion kautta. callback.php osoittaa tämän varmentamisen ilmoituksille ja selaimen palautuksille käyttämällä yksityisiä demotietueita. Se ei täytä tilauksia; korvaa väliaikaiset tietueet ja takaisinkutsu TODO tuotantotietokanta- ja toteutustapahtumallasi. Lue mukana tuleva README.
Match maksutapahtuman ja vastaanottavan osoitteen kanssa MochiPay tilaus. Tarkista vastaanottavan lompakon tai lohkoketju Explorer. Varat ovat jo vastaanotettavassa lompakossasi; alustan nostopyyntöä ei ole.
Käytä yhteensopivaa lompakkoa ja odota blockchain vahvistuksia, kun siirrät varoja. Lue vastaanotto-lompakon hallinta opas →
Perintä ja tarkat määrät
Jatka yritystä ennen Luo tilaus. Nykyinen PHP-demo tallentaa request_id:n ja tarkan hyötykuorman ennen tilauksen luomista. Kun aikakatkaisu on kulunut ilman tallennettua järjestelmätunnusta, yritä uudelleen samaa hyötykuormaa ja request_id; sen sijaan kysytään tunnettua order_id. Kauppiastilausten viittaukset voivat toistua; Käytä järjestelmän tilaustunnusta tai tallennettua pyyntötunnusta maksun tunnistamiseen. Säilytä desimaalivastearvot merkkijonoina ennen PHP- tai JavaScript-kellumuunnosa; näyttää pay_amount tarkasti. Mukana oleva QR koodaa vain osoitteen, joten asiakkaiden on syötettävä näytettävä summa.
Kun rakennat omaa API-asiakasta
Käyttö X-Mochi-Key sekä X-Mochi-Signature. Create Order allekirjoittaa tarkan JSON kehon käyttäen Base64 koodattu HMAC-SHA256. Kyselytilaus allekirjoittaa tarkan kyselyjonon ilman johtavaa kysymysmerkkiä. Pidä allekirjoitussalassa.
Jos testi ei valmistu
Maksuvaihtoehtoa tai tilausta ei voida luoda
Tarkista tilaustila, aktiivinen vastaanottava lompakko, maksutapakoodi, tunnusluvut ja valuuttapari tilausvaluutalle. Liitännäisten osalta tarkista myös, että menetelmä on käytössä testissä käytettävän myymälän tai asiakkaan osalta.
Maksu odottaa tai alipalkataan
Vertaa omaisuuserää, verkkoa, osoitetta ja tarkkaa maksettavaa määrää transaktioon. Odota tarvittavia vahvistuksia. Älä merkitse vain kuvakaappaukseen tai selaimen palautukseen perustuvaa tilausta.
MochiPay maksetaan, mutta myymälää/sovellusta ei päivitetä
Tarkista, että ilmoituksen/kutsun päätetapahtumat ovat julkisesti saavutettavissa HTTPS:n kautta eikä niitä estetä tunnistamisella tai palomuurilla. Vahvista integraatio voi tiedustella MochiPay ja tarkastaa sen virhe lokit. Maksu linkit yksin päivittää MochiPay, ei ulkoinen kauppa.
Vapaaehtoinen pyyntö
Nykyiset integraatiot toimivat edelleen ilman request_id:tä. Jos haluat käyttää samaa maksumääräystä uudelleen aikakatkaisun jälkeen, lisää valinnainen request_id allekirjoitettuun JSON-runkoon ennen nykyisen HMAC-allekirjoituksen laskemista.
{"merchant_order_id":"STORE-1001","amount":25,"currency":"USD","payment_method":"USDT_TRC20","request_id":"STORE-1001:create:v1"}
Käytä 1–64 ASCII-kirjaimia, numeroita, pisteitä, alaviivoja, kaksoispisteitä tai tavuviivoja. Avain kuuluu yhdelle kauppiaalle ja yhdelle pyynnölle. Käytä samaa avainta ja hyötykuormaa uudelleen yrittämiseen; vastaukset säilyttävät olemassa olevat kentät ja palauttavat alkuperäisen järjestyksen nykyiseen tilaan. Avaimet säilytetään ilman automaattista vanhenemista. Käytä jokaisessa uudessa kassassa uutta request_id. merchant_order_id voi pysyä samana: 123, 124, 124 luo kolme itsenäistä järjestelmätilausta. Aikaisempi maksamaton tilaus ei estä luomista. Vain saman pyynnön uudelleenyritys käyttää uudelleen sen request_id ja muuttumaton hyötykuorma. WEB82.6 mainostaa request-id-v1; kysy tallennettua request_id ratkaistaksesi epävarma vastaus. Toistuvat kauppiasviittaukset eivät ole palautusavain. Ota WEB82.6 tai uudempi käyttöön ennen integrointipaketteja; WEB82.7 lisää HPP cancel/return.
HTTP 409 REQUEST_IN_PROGRESS: yritä samaa pyyntöä uudelleen Yritä uudelleen-jälkeen -viiveen jälkeen. HTTP 409 REQUEST_ID_CONFLICT: avainta käytettiin uudelleen eri hyötykuorman kanssa. Älä luo uutta avainta vain ohittaaksesi aikakatkaisun. ON_SITE ja HPP voivat molemmat käyttää palautettuja maksukenttiä tai payment_url kuten ennenkin.