Demo ya moja kwa moja

API ya malipo ya usafiri

API ya Lango la Malipo kwa uhifadhi wa safari: kuanzia checkout hadi kurejesha pesa

API ya lango la malipo ndiyo inayowezesha tovuti yako ya uhifadhi kupokea pesa za msafiri bila kuwahi kugusa kadi. Ukurasa huu unapitia miito ya malipo moja ya kadi, hali ambazo malipo hupitia, kwa nini malipo ya usafiri ni magumu kuliko ya rejareja, na jinsi PHPTRAVELS inavyounganisha mtiririko wako wa uhifadhi na lango unalochagua.

  • Kikao, 3-D Secure, capture
  • Kila hali ya malipo
  • Kadi, pochi, benki, mkopo
  • Hakuna data ya kadi kwenye seva yako

Jinsi miito inavyofanya kazi

Malipo moja ya kadi, mwito baada ya mwito

API ya lango la malipo ni seti ya huduma za wavuti ambazo kampuni ya malipo huwafungulia wafanyabiashara. Seva yako inaomba malipo yaundwe kwa kiasi na sarafu fulani, msafiri anaingiza kadi kwenye fomu ya lango lenyewe, kisha lango linawasiliana na mtandao wa kadi na benki iliyotoa kadi. Seva yako haioni kamwe nambari ya kadi; inarudishiwa kitambulisho cha malipo na hali.

Pande nne zinahusika. Mchoro unazionyesha kama safu wima na kila ujumbe kama mshale wenye nambari. Majina hutofautiana kati ya lango moja na jingine (payment intent, kikao, oda, charge), lakini mfuatano ni uleule.

Msafiri akilipia safari mtandaoni huku tovuti ya uhifadhi, lango la malipo na benki zikibadilishana ujumbe wa malipo

Mshale wa vistari ni webhook: lango linaiita seva yako lenyewe, hivyo malipo bado yanasasisha uhifadhi hata msafiri akifunga kivinjari. Ukurasa wa Uunganishaji wa lango za malipo unaeleza jinsi kila hatua inavyofungamana na uhifadhi ndani ya PHPTRAVELS.

  • Msafiri
  • Tovuti yako
  • Lango
  • Mtandao wa kadi / benki

  1. 01CheckoutMsafiri Tovuti yako

    Msafiri anakagua safari na kubonyeza Lipa. Uhifadhi unashikiliwa kwa msambazaji, bado haujathibitishwa.

  2. 02Unda payment intent au kikaoTovuti yako Lango

    Seva yako inatuma kiasi, sarafu, rejeleo la uhifadhi na ufunguo wa idempotency pamoja na ufunguo wa siri wa API. Lango linarudisha kitambulisho cha malipo.

  3. 03Sehemu zilizohifadhiwa au uelekezajiLango Msafiri

    Fomu ya kadi hutolewa na lango, ndani ya ukurasa wako au kwenye ukurasa wake, hivyo data ya kadi huenda moja kwa moja kwake.

  4. 043-D SecureMtandao wa kadi / benki Msafiri

    Benki iliyotoa kadi ikihitaji, msafiri anathibitisha malipo kwenye programu ya benki au kwa msimbo wa mara moja.

  5. 05IdhiniLango Mtandao wa kadi / benki

    Lango linaomba benki iliyotoa kadi iidhinishe kiasi kupitia mtandao wa kadi.

  6. 06Imeidhinishwa, fedha zimeshikiliwaMtandao wa kadi / benki Lango

    Benki inatenga pesa kwenye kadi. Bado hakuna kilichohamishwa.

  7. 07Matokeo kwa tovuti yakoLango Tovuti yako

    Msafiri anarudi kwenye tovuti yako na kitambulisho cha malipo. Seva yako inasoma hali kutoka kwa API na kuthibitisha uhifadhi kwa msambazaji.

  8. 08CaptureTovuti yako Lango

    Msambazaji akishathibitisha, seva yako inafanya capture ya kiasi kamili au kidogo zaidi. Malango mengi pia yanaweza kufanya capture mara moja.

  9. 09WebhookLango Tovuti yakoHutumwa na lango lenyewe

    Lango linatuma tukio lenye sahihi (malipo yamekamatwa, yamerejeshwa, yamepingwa) kwenye endpoint yako. Seva yako inakagua sahihi na kusasisha uhifadhi.

Hali za malipo

Maisha ya malipo kama mashine ya hali

Kila API ya lango huripoti hali ya kila malipo. Maneno hutofautiana, lakini yanaelekeza kwenye hali zilezile chache, na mantiki ya uhifadhi wako inapaswa kuitikia kila moja.

  1. created

    Imeundwa

    Malipo yapo yakiwa na kiasi na sarafu, yakimsubiri msafiri.

    failedYa mwisho

    Imeshindwa

    Imekataliwa, 3-D Secure haikukamilika au iliachwa. Hakuna kinachotozwa.

  2. authorized

    Imeidhinishwa

    Benki iliyotoa kadi imeidhinisha kiasi na inakishikilia kwenye kadi.

    voidedYa mwisho

    Imebatilishwa (void)

    Ushikiliaji unafutwa kabla ya capture, hivyo msafiri hatozwi kamwe.

  3. captured

    Imekamatwa (captured)

    Pesa imechukuliwa na itawekwa kwenye akaunti yako ya mfanyabiashara.

    partially_refundedYa mwisho

    Imerejeshwa kwa sehemu

    Sehemu ya kiasi kilichokamatwa inarudishwa, kwa mfano baada ya ada ya kughairi.

    refundedYa mwisho

    Imerejeshwa

    Kiasi chote kilichokamatwa kinarudishwa kwenye kadi.

Idhini haidumu milele: isipokamatwa kwa wakati, ushikiliaji unaisha muda na benki inaachilia pesa. Malipo yaliyorejeshwa kwa sehemu yanaweza kurejeshwa zaidi, hadi kiasi kilichokamatwa.

Kwa nini usafiri ni mgumu zaidi

Kwa nini malipo ya usafiri ni tofauti

Duka huuza kilichopo dukani. Muuzaji wa safari hupokea pesa kwa uhifadhi ambao msambazaji bado anapaswa kuuthibitisha, mara nyingi miezi kabla ya safari. API ya malipo lazima iendane na hilo.

  • 01

    Idhinisha sasa, fanya capture baadaye

    Hoteli za kuomba, nauli za vikundi na ziara huthibitishwa saa au siku baada ya oda. Kuidhinisha kwanza na kufanya capture wakati wa uthibitisho kunamaanisha hakuna malipo kwa uhifadhi usiotokea.

  • 02

    Msambazaji bado anaweza kukataa

    Nauli inaweza kuisha kati ya malipo na utoaji wa tiketi. Kukiwa na idhini, pesa huachiliwa kwa void; baada ya capture inakuwa marejesho.

  • 03

    Marejesho ya sehemu baada ya ada za kughairi

    Kughairi malazi au tiketi kwa kawaida huacha ada. Mwito wa marejesho hutuma kiasi kidogo zaidi dhidi ya malipo ya awali, mara nyingi kadiri sheria zinavyohitaji.

  • 04

    Sarafu nyingi

    Wasafiri hulipa kwa sarafu yao huku wasambazaji wakitoa ankara kwa sarafu zao. Lango lazima liunge mkono sarafu ya kuonyeshwa, na kumbukumbu zako lazima zihifadhi kiasi vyote viwili.

  • 05

    Ukaguzi wa ulaghai kwa thamani kubwa

    Tiketi za kesho, za mtu mwingine, zilizolipwa kwa kadi mpya ni mfumo wa kawaida wa ulaghai. 3-D Secure, alama za hatari za lango na foleni ya ukaguzi wa mkono hulinda oda za thamani kubwa.

  • 06

    Chargeback miezi baadaye

    Migogoro mara nyingi huja baada ya safari. Hifadhi pamoja matokeo ya uthibitishaji, nyaraka za uhifadhi na matukio ya lango, ili uweze kujibu kila mmoja kwa ushahidi.

Njia za malipo

Njia za kulipa ambazo API ya lango la malipo inashughulikia

Kadi ni chaguo moja tu. Wasafiri na mawakala hulipa kwa njia tofauti, na kila moja hurejeshwa kwa njia tofauti.

NjiaNi niniPesa inafika liniMarejesho
KadiKadi za debit na credit kupitia lango, pamoja na 3-D Secure benki ikihitaji.Huidhinishwa wakati wa checkout; capture mara moja au msambazaji anapothibitisha.Marejesho kamili au ya sehemu kwenye kadi ileile kupitia API.
Pochi za kidijitaliAkaunti za pochi zinazoungwa mkono na lango, kama PayPal au pochi ya simu yenye kadi iliyofanywa token.Wakati wa checkout, baada ya msafiri kuidhinisha kwenye pochi.Hurudi kwenye pochi au kadi iliyo nyuma yake, kupitia lango.
Uhamisho wa benkiMsafiri au wakala anatuma pesa kwenye akaunti yako ya benki na malipo yanarekodiwa kwenye uhifadhi.Siku kadhaa baadaye; uhifadhi unasubiri hadi timu yako ithibitishe kupokea.Hulipwa kwa uhamisho, nje ya lango.
Lipa baadayeUhifadhi unafanywa sasa na kulipwa baadaye; timu yako inarekodi malipo yakifika.Baada ya uhifadhi, msafiri anapolipa.Kinachorudishwa ni kile tu kilicholipwa kweli.
Pochi au mkopo wa wakala wa B2BMawakala wadogo hulipa kutoka salio wanalojaza mapema au kikomo cha mkopo unachowapa.Hukatwa wakati wa uhifadhi; amana na mkopo hukamilishwa kwa masharti yako.Hurudishwa kwenye salio la wakala.

Uhamisho wa benki, lipa baadaye na salio la pochi ni njia za kukamilisha malipo za jukwaa lenyewe, si malango. Salio na vikomo vya mkopo vya mawakala vinaelezwa kwenye ukurasa wa Pochi ya wakala B2B; malipo ya benki kwenye ukurasa wa Malipo kwa uhamisho wa benki.

Tayari ndani ya PHPTRAVELS

API za malango ya malipo zilizokwisha unganishwa

Malango haya tayari yameunganishwa na PHPTRAVELS. Unafungua akaunti ya mfanyabiashara kwa mtoa huduma, unaingiza funguo za API kwenye admin, unajaribu kwenye sandbox yake kisha unaanza kutumia. Orodha ni ya moja kwa moja kutoka saraka yetu ya miunganisho.

Ada na idhini ya mfanyabiashara hukubaliwa na kampuni ya malipo, si na PHPTRAVELS. Lango lisilokuwepo hapa linaweza kuongezwa kama Muunganisho wa API maalum, na ukurasa wa Uunganishaji wa lango za malipo unaeleza jinsi kila moja linavyowekwa.

Usalama

Kuweka data ya kadi nje ya mfumo wako

Nambari salama zaidi ya kadi ni ile ambayo seva yako haipokei kamwe. API ya lango la malipo imejengwa ili isilazimike kuipokea.

  • Usihifadhi kamwe nambari za kadi

    Maelezo ya kadi huenda kwenye lango, linalorudisha token au kitambulisho cha malipo. Hifadhidata yako inahifadhi rejeleo hilo, si nambari ya kadi wala msimbo wa usalama.

  • Sehemu zilizohifadhiwa na uelekezaji hupunguza wigo wa PCI DSS

    PCI DSS inamhusu yeyote anayeshughulikia data ya kadi. Fomu ya kadi ikiwa ni ukurasa wa lango au sehemu zilizopachikwa, sehemu ndogo zaidi ya mfumo wako iko ndani ya wigo. Acquirer wako anathibitisha ni tathmini ya kibinafsi ipi inakuhusu.

  • Webhook zinathibitishwa kwa sahihi

    Kila webhook hubeba sahihi iliyotengenezwa kwa siri ya pamoja. Seva yako inaihesabu upya na kukataa tukio lolote lisilolingana, hivyo hakuna anayeweza kughushi uhifadhi uliolipwa.

  • Funguo za siri hubaki kwenye seva

    Kivinjari hupokea ufunguo wa umma tu. Ufunguo wa siri unaounda malipo na marejesho uko kwenye usanidi wa seva yako, na kila ombi hubeba ufunguo wa idempotency ili jaribio la pili lisitoze mara mbili.

webhook.php
 1$payload   = file_get_contents("php://input"); 2$signature = $_SERVER["HTTP_X_SIGNATURE"] ?? ""; 3$expected  = hash_hmac("sha256", $payload, $webhookSecret); 4 5if (!hash_equals($expected, $signature)) { 6    http_response_code(400); exit;      // reject 7} 8$event = json_decode($payload, true); 9if (alreadyHandled($event["id"])) exit; // repeat delivery10updateBooking($event["data"]["metadata"]["booking_ref"], $event["type"]);

Mfano wa jumla. Majina ya vichwa na njia ya kusaini hufuata lango unalochagua.

PHPTRAVELS ni programu ya kujiendeshea (self-hosted), kwa hiyo utiifu wa PCI DSS hutathminiwa kwa biashara na seva yako, si kwa programu peke yake.

Tazama uhifadhi ukilipwa, ukikamatwa na kurejeshwa

Hifadhi safari kwenye demo ya moja kwa moja na ufuatilie malipo kwenye admin. Kwenye mpango wa Enterprise, PHPTRAVELS pia inakupa REST API na webhook zake kwa programu zako na washirika.

Unapanga pia safari za ndege? Ukurasa wa API ya Safari za Ndege unaeleza upande wa wasambazaji, na API za usafiri inaorodhesha kila API ambayo PHPTRAVELS inaunganisha.

Jaribu demo ya moja kwa mojaLinganisha mipangoSoma nyaraka za wasanidi programu

Maswali ya mara kwa mara

API ya lango la malipo: maswali ya wauzaji wa safari

Zungumza na mauzo

Ni seti ya huduma za wavuti anazotoa kampuni ya malipo ili tovuti iweze kuunda malipo, kutuma kadi benki ili iidhinishwe, kufanya capture ya pesa, kutoa marejesho na kupokea masasisho ya hali kwa webhook, bila kuhifadhi data ya kadi yenyewe.

Lango ni sehemu ambayo tovuti yako inawasiliana nayo: hukusanya kadi kwa usalama na kupitisha ombi. Kichakataji hupitisha muamala kupitia mitandao ya kadi hadi benki iliyotoa kadi. Watoa huduma wengi hutoa vyote viwili kama huduma moja.

Ile inayoidhinisha biashara yako, inayounga mkono nchi, sarafu na njia za malipo za wateja wako, na yenye idhini na capture tofauti pamoja na marejesho ya sehemu. Mawakala wengi huchanganya lango la kadi la kimataifa na la kikanda.

Kuidhinisha kunatenga kiasi kwenye kadi ya msafiri; capture huchukua pesa. Kutenganisha hatua hizi hukuwezesha kutoza tu msambazaji akishathibitisha uhifadhi, na kubatilisha ushikiliaji asipothibitisha.

Katika maeneo mengi, ikiwemo Eneo la Kiuchumi la Ulaya na Uingereza, uthibitishaji madhubuti wa mteja unahitajika kwa malipo mengi ya kadi mtandaoni, na 3-D Secure ndiyo njia kadi zinazoutimiza. API ya lango hushughulikia changamoto hiyo; mtiririko wako wa uhifadhi unasubiri matokeo.

Si yenyewe pekee. Kutumia sehemu zilizohifadhiwa au ukurasa wa malipo wa lango huweka data ya kadi nje ya seva yako na kupunguza wigo wa PCI DSS, lakini bado unapaswa kukamilisha tathmini anayoomba acquirer wako.

Ndiyo, lango likiunga mkono marejesho ya sehemu, kama malango mengi ya kadi. Unatuma marejesho ya kiasi kidogo zaidi dhidi ya malipo ya awali, kwa mfano bei ukiondoa ada ya kughairi.

Hapana. Unafungua akaunti ya mfanyabiashara kwa lango unalochagua na kukubaliana nalo kuhusu ada. PHPTRAVELS inaunganisha jukwaa lako la uhifadhi na akaunti hiyo kwa funguo za API unazoingiza kwenye admin.

Ndiyo. Lango lolote lenye API iliyoandikwa nyaraka linaweza kuongezwa kama muunganisho maalum, na kwa kuwa msimbo wa chanzo umejumuishwa, wasanidi wako wanaweza pia kupanua mtiririko wa malipo.

Endelea kuchunguza

Zaidi kuhusu jukwaa