Kaip integruoti Opay į savo svetainę: Išsamus gidas

Kas yra OPay?

OPay – tai mokėjimų priėmimo sistema, leidžianti verslams priimti įvairius mokėjimo metodus, tokius kaip banko kortelės, banko pavedimai, „Apple Pay“, „Google Pay“ ir kt. OPay siūlo įvairius integracijos būdus, įskaitant serverio API, iš anksto sukurtus įskiepius ir mobiliuosius SDK.

Kaip pradėti naudotis OPay?

1. Susikurkite OPay verslo paskyrą

1. Apsilankykite OPay svetainėje: https://opayweb.com.

2. Užpildykite registracijos formą ir pateikite reikiamą informaciją apie savo verslą.

3. Patvirtinkite savo paskyrą ir prisijunkite prie OPay verslo administravimo skydelio.

2. Gaukite API raktus

1. Prisijunkite prie savo OPay paskyros.

2. Eikite į „Developer Tools“ skiltį.

3. Pasirinkite „API Keys“ ir sugeneruokite naujus raktus.

4. Išsaugokite „clientAuthKey“ ir „clientSecret“ – šie raktai bus reikalingi integracijai.

Kaip atlikti OPay integraciją į savo svetainę?

1. Pasirinkite integracijos metodą

Priklausomai nuo jūsų svetainės poreikių, galite pasirinkti vieną iš šių integracijos metodų:

• Express Checkout: Naudokite OPay sukurtą mokėjimo puslapį su minimalia integracija.

• Server-to-Server API: Pilnai pritaikyta integracija su savo dizainu ir funkcionalumu.

2. Server-to-Server API integracija

1. Sukurkite užsakymą:

   Naudokite šį API galą, kad sukurtumėte mokėjimo užsakymą:

   POST https://payapi.opayweb.com/openApi/order/checkout/createOrder
   

   Užklausos kūnas (JSON):

   {
     "headMerchantId": "Jūsų_Opay_verslo_ID",
     "merchantId": "Jūsų_Opay_šakos_ID",
     "outOrderNo": "unikalus_verslo_užsakymo_numeris",
     "amount": 1000,
     "currency": "NGN",
     "orderExpireTime": 180,
     "sceneEnum": "CASH_API",
     "subSceneEnum": "FILM",
     "sn": "POS_serijos_numeris",
     "isSplit": "N",
     "productInfo": {
       "filmName": "filmo_pavadinimas",
       "filmTitle": "bilieto_pavadinimas",
       "filmTicketNum": "bilieto_numeris",
       "seatNum": "sėdimos_vietos_numeris",
       "filmTicketAmount": 1,
       "filmFeeAmount": 1,
       "filmDate": "2025-04-22",
       "filmTime": "20:00"
     },
     "remark": "Papildoma_informacija"
   }
   

   Atsakymas (JSON):

   {
     "code": "00000",
     "message": "SUCCESSFUL",
     "data": {
       "orderNo": "OPay_mokėjimo_užsakymo_numeris"
     }
   }
   

2. Peradresuokite klientą į OPay mokėjimo puslapį:

   Naudodami gautą orderNo, sukurkite URL:

   https://pay.opayweb.com/checkout?orderNo=OPay_mokėjimo_užsakymo_numeris
   

   Peradresuokite klientą į šį URL, kad jis galėtų atlikti mokėjimą.

3. Gaukite mokėjimo statusą:

   Naudokite šį API galą, kad patikrintumėte užsakymo būseną:

   POST https://payapi.opayweb.com/openApi/order/checkout/queryOrderStatus
   

   Užklausos kūnas (JSON):

   {
     "orderNo": "OPay_mokėjimo_užsakymo_numeris"
   }
   

   Atsakymas (JSON):

   {
     "code": "00000",
     "message": "SUCCESSFUL",
     "data": {
       "status": "SUCCESS"
     }
   }
   

   Galimi statusai:

   • SUCCESS: Mokėjimas sėkmingas.

   • FAIL: Mokėjimas nepavyko.

   • PENDING: Laukia apdorojimo.

Kaip gauti papildomą informaciją?

Daugiau informacijos ir detalių galite rasti oficialioje OPay dokumentacijoje:

• OPay dokumentacija

• Server-to-Server API vadovas

• E-Wallet Payments API

Papildomi patarimai

• Testavimas: Naudokite OPay „Sandbox“ aplinką, kad išbandytumėte integraciją prieš pereinant į gyvą režimą.

• Saugumas: Užtikrinkite, kad visi API raktai ir slapti duomenys būtų saugomi saugiai ir nebūtų atskleisti.