Demo ya moja kwa moja

Malipo kwa programu za safari

Muunganisho wa API ya Paddle: wakati merchant of record inafaa biashara ya safari

Paddle huuza programu, SaaS na bidhaa za kidijitali kwa niaba yako kama merchant of record. Hilo huifanya iwe chaguo imara kwa kampuni ya teknolojia ya safari inayotoza usajili wake yenyewe, na mara nyingi si zana sahihi ya kupokea fedha za ndege, hoteli na ziara. Ukurasa huu unaeleza tofauti hiyo, jinsi muunganisho wa Paddle unavyofanya kazi, na jinsi ya kuuunganisha na PHPTRAVELS pale hali yako inapofaa.

  • Merchant of record, si lango
  • Imejengwa kwa programu na usajili
  • Webhook zilizotiwa saini
  • Huunganishwa kama muunganisho maalum

Miundo miwili tofauti

Merchant of record dhidi ya lango la malipo

Lango la malipo husogeza pesa kwa niaba yako: wewe ndiye muuzaji, kampuni ya malipo huchakata kadi, na kodi, ankara, marejesho na migogoro hubaki jukumu lako. Merchant of record huenda hatua moja zaidi na kuwa muuzaji machoni pa mteja na mamlaka za kodi. Mtu anaponunua kupitia Paddle, Paddle ndiye anayemuuzia, hukusanya na kuwasilisha kodi ya mauzo au VAT, hutoa ankara, hushughulikia chargeback kisha hukulipa sehemu yako.

Muundo huu humwokolea kampuni ya programu kazi nyingi za kodi na utiifu, lakini pia unamaanisha Paddle ndiyo huamua inachokubali kuuza tena. Jukwaa lake limejengwa kwa programu, SaaS na bidhaa za kidijitali, si huduma za safari zinazotolewa na mashirika ya ndege, hoteli na waendeshaji wa ziara. Misingi ya jumla ya malipo ya kadi imeelezwa kwenye ukurasa wa API ya Lango la Malipo.

Mchoro wa mtiririko wa malipo unaoonyesha mteja akilipa mtandaoni huku majukumu ya malipo, kodi na utoaji wa fedha yakipita kati ya muuzaji na mtoa huduma wa malipo
SwaliPaddle (merchant of record)Lango la malipo
Muuzaji ni nani?Paddle ndiye muuzaji rasmi. Risiti na taarifa ya kadi ya mteja hutoka upande wa Paddle wa mauzo.Wewe ndiye muuzaji. Lango hushughulikia malipo tu kwenye akaunti yako ya mfanyabiashara.
Nani hushughulikia kodi ya mauzo na VAT?Paddle hukokotoa, hukusanya na kuwasilisha kodi ya mauzo na VAT katika maeneo inakouza.Wewe, kupitia usajili wako wa kodi, mhasibu wako na utoaji wa ankara.
Nani hutoa ankara?Paddle hutoa ankara au risiti kwa mnunuzi.Mfumo wako hutoa, kwa mfano ankara ya uhifadhi kwenye admin yako.
Nani hushughulikia chargeback?Paddle hushughulikia migogoro na chargeback kama muuzaji.Wewe hujibu migogoro kwa ushahidi kupitia dashibodi au API ya lango.
Unaweza kuuza nini?Programu, SaaS, usajili na bidhaa za kidijitali, ndani ya sheria za matumizi yanayokubalika za Paddle.Mauzo ya bidhaa na huduma ambayo lango huidhinisha, ikiwemo uhifadhi wa safari kwa wafanyabiashara wengi wa sekta hii.
Unalipwaje?Paddle hukulipa mapato yako baada ya ada zake, kwa ratiba yake ya malipo.Malipo yaliyokusanywa hukamilishwa kwenye akaunti yako ya mfanyabiashara au benki, ukiondoa ada za lango.

Ada, nchi zinazotumika na orodha kamili ya bidhaa zinazoruhusiwa huwekwa na Paddle na hubadilika baada ya muda. Angalia masharti ya Paddle yenyewe kabla ya kuipangia.

Msaidizi wa uamuzi

Je, Paddle inafaa unachouza?

Anza na kile ambacho mteja analipia. Chagua hali iliyo karibu zaidi na biashara yako.

01

Wasafiri hulipia ndege, hoteli na ziara

Mteja ananunua safari inayotolewa na shirika la ndege, hoteli au mwendeshaji wa ziara. Malipo kama haya mara nyingi huhitaji kuidhinisha sasa na kukusanya baadaye, marejesho ya sehemu baada ya ada za kughairi na checkout ya sarafu nyingi.

Maoni yetu

Tumia lango la malipo

Angalia sheria za matumizi yanayokubalika za Paddle kabla ya kuitumia kwa uhifadhi wa safari. Biashara nyingi za safari hupokea malipo ya uhifadhi kupitia lango la malipo kama Stripe, PayPal, Adyen au lango la kikanda.

02

Unauza programu yako ya safari au SaaS

Wewe ni muuzaji wa teknolojia ya safari na mawakala wanakulipa usajili wa kila mwezi au mwaka kwa zana yako ya uhifadhi, ufikiaji wa API, programu-jalizi au portal ya white label.

Maoni yetu

Paddle inaweza kufaa

Huu ndio aina ya mauzo ambayo merchant of record imejengwa kushughulikia: Paddle hutoza usajili, hushughulikia kodi katika kila nchi na kukulipa, kwa hivyo huhitaji kujisajili VAT kila mahali walipo wateja wako.

03

Unauza uhifadhi na programu

Wakala wako anaendesha tovuti ya uhifadhi kwa wasafiri na pia anatoa leseni ya jukwaa au zana zake kwa mawakala wengine.

Maoni yetu

Tumia vyote, kando kando

Pokea malipo ya uhifadhi kupitia lango tayari kwenye mtiririko wa uhifadhi, na utoze usajili wa programu kupitia Paddle. Mitiririko miwili, seti mbili za kumbukumbu, kila moja ikiwa na mtazamo sahihi wa kodi.

Jinsi inavyofanya kazi

Jinsi muunganisho wa Paddle unavyofanya kazi, tangu mwanzo hadi mwisho

Paddle Billing hufanya kazi na bidhaa na bei unazounda ndani ya Paddle, checkout inayofunguliwa na Paddle.js, na webhook zinazoarifu seva yako kilichotokea.

  1. 01

    Bidhaa na bei

    Unaunda kila mpango mara moja ndani ya Paddle, kwa mfano bei ya kila mwezi na ya kila mwaka, kisha unahifadhi vitambulisho vya bei kwenye mfumo wako.

    pri_…

  2. 02

    Checkout ya Paddle.js

    Ukurasa wako hupakia Paddle.js na kufungua checkout kama kifuniko au fremu ya ndani, ikiwa na kitambulisho cha bei na rejeo lako la mteja.

    Paddle.Checkout.open()

  3. 03

    Muamala umekamilika

    Mnunuzi hulipa, Paddle hutoza kadi au pochi, hutumia kodi na kuunda muamala, na usajili iwapo bei inajirudia.

    txn_…

  4. 04

    Webhook iliyotiwa saini

    Paddle hutuma tukio kama transaction.completed kwenye endpoint yako, likiwa limetiwa saini kwenye kichwa cha Paddle-Signature.

    transaction.completed

  5. 05

    Mfumo wako unachukua hatua

    Seva yako huthibitisha saini, kisha huwasha akaunti, kusasisha mpango au kurekodi malipo.

    200 OK

Weka ufunguo wa API kwenye seva yako pekee. Kivinjari hutumia tokeni tofauti ya upande wa mteja, na mazingira ya sandbox na live kila moja ina funguo, bei na siri za webhook zake.

Usalama wa webhook

Kukagua kichwa cha Paddle-Signature

Webhook inaweza kughushiwa na yeyote anayejua URL ya endpoint yako. Kuthibitisha saini ya kila tukio ndiko kunakofanya iwe salama kuwasha akaunti kutokana na webhook.

paddle-webhook.php
 1$raw    = file_get_contents("php://input"); 2$header = $_SERVER["HTTP_PADDLE_SIGNATURE"] ?? "";  // ts=…;h1=… 3parse_str(str_replace(";", "&", $header), $sig); 4 5$expected = hash_hmac("sha256", $sig["ts"] . ":" . $raw, $endpointSecret); 6if (!hash_equals($expected, $sig["h1"] ?? "")) { 7    http_response_code(400); exit;            // not from Paddle 8} 9if (time() - (int) $sig["ts"] > $tolerance) exit; // too old1011$event = json_decode($raw, true);12if (alreadyHandled($event["event_id"])) exit;      // repeat delivery13if ($event["event_type"] === "transaction.completed") {14    activatePlan($event["data"]["custom_data"]["account_id"]);15}16http_response_code(200);

Mfano wa kielelezo katika PHP safi. Fuata nyaraka za sasa za Paddle, au SDK yake rasmi, kwa muundo kamili.

  1. 01

    Tumia mwili ghafi

    Saini hukokotolewa juu ya mwili wa ombi kama ulivyopokelewa, kwa hivyo usome kabla uchanganuzi wowote wa JSON haujaubadilisha.

  2. 02

    Muhuri wa wakati pamoja na hash

    Kichwa hubeba muhuri wa wakati na hash ya HMAC-SHA256 iliyotengenezwa kwa ufunguo wa siri wa endpoint yako. Ijenge upya na ulinganishe kwa muda usiobadilika.

  3. 03

    Kataa matukio ya zamani na yanayojirudia

    Kataa matukio yenye muhuri wa wakati wa zamani mno, na uhifadhi kitambulisho cha kila tukio ili uwasilishaji unaorudiwa usichakatwe mara mbili.

  4. 04

    Sandbox kwanza

    Jenga na ujaribu kwenye sandbox ya Paddle kwa kadi za majaribio, kisha ubadilishe funguo, bei na siri kuwa za live.

PHPTRAVELS na Paddle

Kuunganisha Paddle na PHPTRAVELS

Jibu la ukweli kwanza, kisha machaguo.

Paddle si kiunganishi kilicho tayari

Paddle haimo kwenye orodha ya malango ya malipo ya PHPTRAVELS na haina mwongozo wa usanidi uliochapishwa. Malango yaliyo tayari, yanayoonyeshwa hapa chini, ndiyo yaliyojengwa kupokea malipo ya uhifadhi.

Uliza kuhusu muunganisho maalumJaribu onyesho la uhifadhi

  • Kwa malipo ya uhifadhi: lango lililo tayari

    Washa lango lililo tayari kama Malipo ya Stripe au Malipo ya PayPal kwenye admin kwa akaunti yako ya mfanyabiashara. Checkout, marejesho na rejeo la uhifadhi tayari vimeunganishwa kwenye mtiririko wa uhifadhi, kama inavyoelezwa kwenye ukurasa wa Uunganishaji wa lango za malipo.

  • Kwa mauzo ya programu: Paddle kama muunganisho maalum

    Hali yako inapolingana na sheria za Paddle, wasanidi wetu wanaweza kuiunganisha kama Muunganisho wa API maalum: checkout ya Paddle.js kwenye ukurasa wako, endpoint ya webhook iliyothibitishwa na malipo yanayorekodiwa dhidi ya wateja wako. Kazi hupewa bei kabla ya kuanza.

  • Au jenga mwenyewe juu ya msimbo chanzo

    PHPTRAVELS huwekwa kwenye seva yako mwenyewe na huja na msimbo chanzo kamili, kwa hivyo wasanidi wako wanaweza kuongeza Paddle kwa usajili pamoja na injini ya uhifadhi. Ukurasa wa Bei unaorodhesha kila leseni inajumuisha nini.

Tayari kwa malipo ya uhifadhi

Malango ya malipo yaliyokwisha unganishwa na PHPTRAVELS

Kwa malipo ya wasafiri na mawakala, malango haya yako tayari: unafungua akaunti kwa mtoa huduma, unaweka funguo kwenye admin, unajaribu na kuanza kutumia. Orodha ni ile ya moja kwa moja kutoka saraka yetu ya miunganisho.

Mawakala wasaidizi pia wanaweza kulipa kutoka salio lililolipiwa awali au kikomo cha mkopo kupitia Pochi ya wakala B2B, ambacho hakihitaji lango lolote.

Maswali

Muunganisho wa API ya Paddle: maswali ya kawaida

Zungumza na mauzo

Si kama kiunganishi kilicho tayari. Paddle haimo kwenye orodha ya malango ya malipo ya PHPTRAVELS. Hali yako ikilingana na sheria za Paddle, kwa mfano kuuza usajili wa programu yako mwenyewe, inaweza kuongezwa kama muunganisho maalum au kujengwa na wasanidi wako juu ya msimbo chanzo uliojumuishwa.

Paddle ni merchant of record iliyojengwa kwa programu, SaaS na bidhaa za kidijitali, kwa hivyo kwa kawaida si zana ya ndege, hoteli au ziara. Angalia sheria za matumizi yanayokubalika za Paddle kabla ya kuitumia kwa uhifadhi wa safari; biashara nyingi za safari hupokea malipo ya uhifadhi kupitia lango la malipo kama Stripe, PayPal, Adyen au lango la kikanda.

Kampuni inayouza kwa mteja kisheria. Inawajibika kukusanya na kuwasilisha kodi ya mauzo au VAT, kutoa ankara, kushughulikia marejesho na chargeback, na huonekana kwenye taarifa ya mteja. Kwa Paddle, Paddle huchukua nafasi hiyo kisha hukulipa.

Lango huchakata malipo kwa niaba yako huku wewe ukibaki muuzaji na kubeba kazi ya kodi na migogoro. Paddle yenyewe huwa muuzaji, jambo linaloondoa kazi hiyo kwa mauzo ya programu lakini linapunguza unachoweza kuuza kupitia hiyo.

Unapouza programu yako mwenyewe badala ya safari: zana ya uhifadhi, API, programu-jalizi au portal ya white label ambayo mawakala hulipia kwa usajili. Paddle inaweza kuwatoza na kushughulikia kodi katika kila nchi.

Paddle hutuma matukio kama muamala uliokamilika au usajili uliosasishwa kwenye URL unayosajili. Kila ombi hubeba kichwa cha Paddle-Signature chenye muhuri wa wakati na hash, ambacho seva yako hukagua kwa ufunguo wa siri wa endpoint kabla ya kuchukua hatua.

Ndiyo. Paddle ina mazingira tofauti ya sandbox yenye akaunti, funguo za API, bei na kadi za majaribio zake. Jenga na ujaribu huko, kisha hamishia usanidi kwenye mazingira ya live.

Ndiyo, kama mitiririko miwili tofauti: injini ya uhifadhi hupokea malipo ya wasafiri kupitia lango lililo tayari, na Paddle hutoza usajili wa programu yako. Weka kumbukumbu zao kando ili kila mauzo yawe na mtazamo sahihi wa kodi.

Endelea kuchunguza

Zaidi kuhusu jukwaa