Demo ya moja kwa moja

Mwongozo wa payment gateway

Muunganisho wa API ya Razorpay kwa tovuti za kuhifadhi safari

Razorpay ni payment gateway ya India inayopokea kadi, UPI, netbanking na pochi za kidijitali kwa rupia. Mwongozo huu unaeleza jinsi malipo ya Razorpay yanavyofanya kazi kwa uhifadhi wa ndege, hoteli au ziara, na hali halisi katika PHPTRAVELS: Razorpay si kiunganishi kilichotayari leo, lakini inaweza kuongezwa kama muunganisho maalum kwenye msimbo chanzo unaomiliki.

  • Kadi, UPI, netbanking, pochi za kidijitali
  • Oda, Checkout, capture
  • Ukaguzi wa saini na webhook
  • Marejesho kamili na ya sehemu

Razorpay kwa mukhtasari

Razorpay ni nini, na nafasi yake katika PHPTRAVELS

Razorpay ni payment gateway ya India. Biashara ya safari inayouzia wateja nchini India huitumia kupokea njia za malipo ambazo wateja hao wanazitarajia wakati wa kulipa: kadi za debit na credit, UPI, netbanking na pochi maarufu, vyote vikitozwa na kusuluhishwa kwa rupia kwenye akaunti ya Razorpay ya mfanyabiashara mwenyewe.

PHPTRAVELS ni jukwaa la kuhifadhi safari linalojihifadhi lenyewe, lenye msimbo chanzo kamili. Payment gateway zake zilizotayari hutoka kwenye orodha ya moja kwa moja ambayo unaiwasha kwa vitambulisho vyako vya mfanyabiashara. Razorpay haimo kwenye orodha hiyo leo, kwa hiyo bado hakuna swichi yake kwenye admin.

Hilo haimaanishi huwezi kuitumia. Kwa kuwa msimbo ni wako, Razorpay inaweza kuongezwa kama Muunganisho wa API maalum, na kwa India tayari kuna gateway iliyotayari: Cashfree. Ukurasa wa Uunganishaji wa lango za malipo unaorodhesha kila gateway unayoweza kuiwasha sasa.

Mchoro wa malipo ya safari mtandaoni: checkout ya uhifadhi ikipitisha malipo ya kadi kwa payment gateway na kurudi kwenye mfumo wa uhifadhi

Karatasi ya ukweli ya Razorpay

Ni nini
Payment gateway kwa biashara nchini India
Njia za malipo
Kadi, UPI, netbanking na pochi za kidijitali
Sarafu
Hutoza na kusuluhisha kwa INR; kiasi hutumwa kwa paise
Funguo za API
Key ID na Key Secret, tofauti kwa hali ya majaribio na hali halisi
Hali katika PHPTRAVELS
Si kiunganishi kilichotayari. Inapatikana kama muunganisho maalum kwenye msimbo chanzo uliojumuishwa
Tayari India leo
Cashfree, inawashwa kwenye admin kwa akaunti yako ya Cashfree
Mwongozo wa kusanidi Cashfree

Mtiririko wa malipo

Malipo moja ya Razorpay kwa uhifadhi wa safari, hatua kwa hatua

Muunganisho wa Razorpay hugawanya kazi kati ya kivinjari cha msafiri na seva yako. Kivinjari kinaonyesha Checkout; seva inaunda oda, inakagua matokeo na kuamua uhifadhi uthibitishwe lini.

  1. 01

    Seva yako

    Unda oda

    Msafiri anapobonyeza Lipa, seva yako inaita Orders API na kiasi kwa paise, sarafu na receipt iliyowekwa kuwa rejeo la uhifadhi. Razorpay inarudisha order_id.

  2. 02

    Kivinjari

    Fungua Razorpay Checkout

    Ukurasa wa uhifadhi unafungua Checkout na Key ID yako na order_id hiyo, ili msafiri alipe hasa kiasi ambacho seva yako imekiweka.

  3. 03

    Kivinjari

    Msafiri analipa

    Msafiri anachagua kadi, UPI, netbanking au pochi na kukamilisha hatua yoyote ambayo benki yake inaomba. Malipo sasa yameidhinishwa.

  4. 04

    Kivinjari

    Checkout inarudisha thamani tatu

    Likifanikiwa, Checkout inarudisha razorpay_payment_id, razorpay_order_id na razorpay_signature, na ukurasa unazituma kwa seva yako.

  5. 05

    Seva yako

    Thibitisha saini

    Seva yako inakokotoa upya saini kutoka order_id na payment_id kwa Key Secret. Ni saini inayolingana pekee inayohesabiwa kuwa malipo halisi.

  6. 06

    Seva yako

    Fanya capture ya malipo

    Kwa capture ya kiotomatiki, Razorpay inafanya capture kwa niaba yako. Kwa capture ya mkono, seva yako inafanya capture baada ya shirika la ndege, hoteli au mtoa huduma wa ziara kuthibitisha, ili mtu yeyote asitozwe kwa uhifadhi ulioshindwa.

  7. 07

    Seva yako

    Thibitisha uhifadhi

    Uhifadhi unabadilika kuwa umelipwa, tiketi au vocha inatolewa na payment_id ya Razorpay inahifadhiwa pamoja na rejeo la uhifadhi.

  8. 08

    Seva yakoSeva hadi seva

    Pokea webhook

    Razorpay pia hutuma matukio kama payment.captured kwenye URL ya webhook yako. Hili linamhusu msafiri anayefunga kichupo kabla ukurasa haujaweza kuripoti.

Saini na webhook

Ukaguzi mbili unaofanya muunganisho wa Razorpay uaminike

Kitu chochote kinachotoka kwenye kivinjari au mtandaoni kinaweza kughushiwa. Muunganisho wa Razorpay huamini malipo tu baada ya kukagua saini iliyotengenezwa kwa siri isiyoondoka kamwe kwenye seva yako.

verify-razorpay.php · kielelezo
 1// 1. After Checkout: verify the payment signature 2$orderId   = $booking["razorpay_order_id"];  // from your own record 3$paymentId = $_POST["razorpay_payment_id"]; 4$signature = $_POST["razorpay_signature"]; 5$expected  = hash_hmac("sha256", $orderId . "|" . $paymentId, $keySecret); 6if (!hash_equals($expected, $signature)) { rejectPayment(); } 7markPaid($booking["ref"], $paymentId); 8 9// 2. Webhook: verify X-Razorpay-Signature over the raw body10$body    = file_get_contents("php://input");11$header  = $_SERVER["HTTP_X_RAZORPAY_SIGNATURE"] ?? "";12$expect  = hash_hmac("sha256", $body, $webhookSecret);13if (!hash_equals($expect, $header)) { http_response_code(400); exit; }14$event = json_decode($body, true);15if (alreadyHandled($event)) exit;          // repeat delivery16switch ($event["event"]) {17  case "payment.captured": confirmBooking($event); break;18  case "refund.processed": markRefunded($event);   break;19}

Pseudo-code ya kielelezo kuonyesha mantiki, si faili ya kunakili moja kwa moja. Fuata nyaraka na SDK za Razorpay kwa miito kamili.

  • Saini ya malipo

    HMAC SHA256 ya order_id, mstari wima na payment_id, ikitumia Key Secret yako kama ufunguo, lazima iwe sawa na razorpay_signature. Linganisha kwa function ya muda usiobadilika.

  • Saini ya webhook

    Kila webhook ina kichwa X-Razorpay-Signature: HMAC SHA256 ya mwili ghafi wa ombi, ikitumia webhook secret uliyoiweka kwenye dashibodi ya Razorpay kama ufunguo.

  • Utumaji unaorudiwa

    Webhook zinaweza kufika zaidi ya mara moja au bila mpangilio. Rekodi vitambulisho vya tukio na malipo, na puuza tukio ambalo tayari limetumika kwenye uhifadhi.

  • Siri hubaki upande wa seva

    Ni Key ID pekee inayokwenda kwenye kivinjari. Key Secret na webhook secret ziko kwenye usanidi wa seva, kamwe si kwenye chanzo cha ukurasa wala programu ya simu.

Marejesho na kughairi

Marejesho ya safari mara chache huwa kiasi kizima

Ada za kughairi, sheria za kutofika na safari zilizoghairiwa kwa sehemu hufanya marejesho ya safari mara nyingi yawe ya sehemu. Refunds API ya Razorpay inashughulikia yote mawili, na muunganisho huamua kiasi kutoka kwa sheria zako za uhifadhi.

  • Marejesho kamili

    Kughairi bila malipo kunarudisha kiasi chote kilichofanyiwa capture kwa njia aliyotumia msafiri kulipa.

  • Marejesho ya sehemu

    Baada ya ada ya kughairi, seva inarejesha salio pekee. Kiasi hutumwa kwa paise, kama oda ya awali.

  • Sehemu ya ratiba ya safari

    Ghairi usiku mmoja wa hoteli au abiria mmoja na rejesha sehemu hiyo; marejesho zaidi ya sehemu yanaweza kufuata hadi jumla iliyofanyiwa capture.

  • refund.processed

    Webhook ya marejesho inaiambia seva yako marejesho yanapokamilika, ili uhifadhi na msafiri waone hali sahihi.

  • Huhifadhiwa pamoja na uhifadhi

    Kila kitambulisho cha marejesho hutunzwa pamoja na rejeo la uhifadhi na payment_id ya awali kwa timu yako ya hesabu.

  • Mfano: kughairi kwa ada

    Imefanyiwa capture
    ₹12,500.00 amount: 1250000
    Ada ya kughairi
    ₹1,500.00 amount: 150000
    Kiasi cha marejesho
    ₹11,000.00 amount: 1100000

    Takwimu za mfano tu. Razorpay hupokea kiasi katika kipimo kidogo kabisa cha sarafu, kwa hiyo paise 100 ni rupia moja.

Jinsi ya kuunganisha Razorpay

Njia tatu za kupokea malipo na Razorpay au bila hiyo

Chagua njia inayofaa timu yako na tarehe yako ya kuzindua. Zote tatu huweka pesa kwenye akaunti yako ya mfanyabiashara; PHPTRAVELS haiwahi kuwa sehemu ya usuluhishi.

  1. Chaguo 1

    Watengenezaji wako wanaiongeza

    PHPTRAVELS huja na msimbo chanzo kamili, kwa hiyo watengenezaji wako wanaweza kuongeza Razorpay kama gateway mpya kando ya zilizopo: kuunda oda, Checkout kwenye hatua ya malipo, ukaguzi wa saini, capture, webhook na marejesho.

    • Jenga na ujaribu kwa funguo za hali ya majaribio za Razorpay
    • Tumia tena rejeo la uhifadhi kama receipt ya oda
    • Badilisha kwenda funguo halisi uhifadhi wa majaribio ukipita
    Nyaraka za API kwa watengenezaji

  2. Chaguo 2

    PHPTRAVELS inaijenga

    Watengenezaji wetu wanaweza kukujengea kiunganishi cha Razorpay kama Muunganisho wa API maalum. Unatuma mahitaji, unapokea gharama na ratiba kabla kazi haijaanza, na unapata msimbo chanzo uliojaribiwa mwishoni.

    • Bei hutolewa kabla kazi haijaanza
    • Imejengwa kwa hali ya majaribio ya Razorpay
    • Inakabidhiwa kama msimbo chanzo unaomiliki
    Omba bei

  3. Chaguo 3

    Tumia gateway iliyotayari sasa

    Ukihitaji kuzindua kwanza, washa gateway ambayo tayari iko kwenye jukwaa. Kwa India ni Cashfree. Gateway zilizotayari leo ni pamoja na:

    Payment gateway zote

Gateway zilizotayari

Payment gateway unazoweza kuwasha leo

Orodha hii inatoka moja kwa moja kwenye saraka ya gateway ya PHPTRAVELS. Kila moja inawashwa kwenye admin kwa akaunti na funguo zako.

Unataka kuelewa miito iliyo nyuma ya yoyote kati yao? Soma mwongozo wa API ya Lango la Malipo, linganisha miongozo ya Malipo ya Stripe na Malipo ya PayPal, au ona jinsi mawakala wanavyolipa kutoka Pochi ya wakala B2B kwenye portal ya B2B.

Maswali kuhusu Razorpay

Razorpay na PHPTRAVELS, majibu

Zungumza na mauzo

Si kama kiunganishi kilichotayari. Razorpay haimo kwenye orodha ya gateway ya PHPTRAVELS leo, kwa hiyo huwezi kuiwasha kwenye admin. Kwa kuwa msimbo chanzo kamili umejumuishwa, inaweza kuongezwa kama muunganisho maalum wa payment gateway, na watengenezaji wako au wetu.

Cashfree ni gateway iliyotayari katika PHPTRAVELS na ina mwongozo wa kusanidi kwenye docs.phptravels.com/payments/cashfree. Unaiwasha kwenye admin kwa akaunti yako ya Cashfree. Gateway nyingine zilizotayari kama Stripe na PayPal zimeorodheshwa kwenye ukurasa wa payment gateway.

Razorpay inapokea kadi, UPI, netbanking na pochi za kidijitali kwa malipo ya rupia za India. Njia zinazoonekana wakati wa kulipa hutegemea kile kilichowashwa kwenye akaunti yako ya Razorpay.

Razorpay hupokea kiasi katika kipimo kidogo kabisa cha sarafu, kwa hiyo jumla ya uhifadhi kwa rupia huzidishwa kwa 100 kabla oda haijaundwa. Kiasi cha marejesho hutumwa vivyo hivyo.

Checkout inarudisha kitambulisho cha malipo, kitambulisho cha oda na saini. Seva yako inakokotoa HMAC SHA256 ya kitambulisho cha oda na cha malipo kwa Key Secret yako na kukubali malipo tu ikiwa matokeo yanalingana na saini.

Capture ya kiotomatiki ni rahisi zaidi. Ya mkono hukuruhusu kufanya capture tu baada ya shirika la ndege, hoteli au mtoa huduma wa ziara kuthibitisha uhifadhi, ili uhifadhi ulioshindwa uachiliwe badala ya kurejeshewa. Uchaguzi unategemea bidhaa na wasambazaji wako.

Ndiyo. Refunds API ya Razorpay inasaidia marejesho kamili na ya sehemu, hivyo ada ya kughairi inaweza kubaki na salio kurudishwa. Webhook ya refund.processed inaiambia seva yako marejesho yanapokamilika.

Ndiyo. Akaunti ya mfanyabiashara, Key ID na Key Secret yake, na usuluhishi wake ni vyako. PHPTRAVELS haitoi kamwe vitambulisho vya gateway wala haishughulikii fedha zako. Jenga kwa funguo za hali ya majaribio na ubadilishe kwenda funguo halisi unapozindua.

Inategemea wigo unaohitaji, kama checkout, capture ya mkono, marejesho na malipo ya mawakala. PHPTRAVELS hutoa bei ya kazi maalum kabla haijaanza. Jukwaa lenyewe ni leseni ya mara moja kuanzia.

Endelea kuchunguza

Zaidi kuhusu jukwaa