Lai izmantotu Clip pakalpojumā MaviBot, jums ir jāizveido akreditācijas datu pāris savā Clip kontā un tie jāievada maksājumu sistēmas iestatījumos.
Clip ir Meksikas maksājumu pakalpojums.
Akreditācijas datu iegūšana
Noslēdziet līgumu ar Clip un iegūstiet piekļuvi Developer Dashboard savā Clip kontā.
Sadaļā ar akreditācijas datiem noklikšķiniet uz Crear credencial (Izveidot akreditācijas datus), ievadiet nosaukumu un apstipriniet izveidi.
Nokopējiet šādus akreditācijas datus:
- API atslēga
- Clave secreta (Slepenā atslēga)
Svarīgi! Slepenā atslēga tiek parādīta tikai vienu reizi, uzreiz pēc akreditācijas datu izveides. Saglabājiet to drošā vietā. Jūs to vairs nevarēsiet apskatīt savā Clip kontā. Ja to pazaudēsiet, jums būs jāizveido jauns akreditācijas datu pāris.
Akreditācijas dati tiek izveidoti atsevišķi ražošanas un testa videi. Vienā kontā var izveidot līdz 6 lietojumprogrammām.
Integrācijas testēšanai izveidojiet testa akreditācijas datu pāri. Lai pieņemtu reālus maksājumus, izmantojiet ražošanas akreditācijas datus.
Jums nav jākonfigurē maksājumu paziņojumu URL savā Clip kontā. MaviBot automātiski nosūta paziņojumu URL, kad tiek izveidots katrs maksājums.
Clip savienošana
Cilnē Acquiring atlasiet Clip un ievadiet:
| Lauks | Apraksts |
|---|---|
| API atslēga | Lietojumprogrammas identifikators. |
| Slepenā atslēga (Clave secreta) | Lietojumprogrammas slepenā atslēga. |
Savienojums tagad ir pabeigts.
Maksājuma saites ģenerēšana
Izmantojiet šādu Kalkulatora funkciju:
get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)
Parametri
| Parametrs | Apraksts |
|---|---|
amount |
Maksājuma summa. Obligāts. Minimālā summa ir 1 galvenajā valūtas vienībā. Norādiet summu kā 100.55, nevis 10055. |
description |
Maksājuma apraksts. Neobligāts. Maksimālais garums: 250 rakstzīmes. Klients to var redzēt maksājuma lapā un čekā. |
currency |
Trīs burtu valūtas kods (MXN un citas valūtas, kas pieejamas jūsu Clip kontā). Neobligāts. Noklusējums: MXN. |
customer_email |
Klienta e-pasta adrese. Neobligāts. Automātiski tiek ievietots maksājuma formā. |
customer_phone |
Klienta tālruņa numurs. Neobligāts. Automātiski tiek ievietots maksājuma formā. |
full_name |
Klienta vārds. Neobligāts. Automātiski tiek ievietots maksājuma formā. |
product_name |
Produkta nosaukums. Neobligāts. |
language |
Maksājuma lapas valoda: es spāņu valodai (noklusējums) vai en angļu valodai. |
Funkcija atgriež maksājuma URL.
Maksājuma saites poga
Lai nosūtītu klientam maksājuma pogu:
- Izveidojiet pogu ar funkciju Pay.
- Atlasiet Clip kā maksājumu sistēmu.
- Norādiet produkta nosaukumu, summu un valūtu.
- Ja nepieciešams, norādiet mainīgos, kas satur klienta vārdu, e-pasta adresi un tālruņa numuru.
Maksājumu atzvanīšana
Pēc tam, kad klients seko maksājuma saitei un pabeidz maksājumu, MaviBot saņem atzvanīšanu.
Veiksmīgs maksājums
Piemērs:
SDJ91MTKTT_success 100.55
Kur:
-
SDJ91MTKTT— pirmās 10 jūsu API atslēgas rakstzīmes. -
100.55— maksājuma summa.
Neveiksmīgs maksājums
Ja maksājums ir neveiksmīgs, tiek nosūtīta šāda atzvanīšana:
SDJ91MTKTT_fail 100.55
Svarīgi! Atzvanīšana par neveiksmīgu maksājumu tiek nosūtīta tikai pēc tam, kad maksājuma saite ir neatgriezeniski aizvērta: pēc 5 neveiksmīgiem maksājuma mēģinājumiem vai kad saite ir beigusies.
Kamēr klientam vēl ir pieejami maksājuma mēģinājumi, saite paliek aktīva un netiek nosūtīta atzvanīšana par neveiksmīgu maksājumu.
Klienta mainīgie pēc veiksmīga maksājuma
| Mainīgais | Apraksts |
|---|---|
clip_callback_data |
Maksājuma informācija, kas saņemta no Clip maksājumu sistēmas. |
clip_payment_completed |
"True", ja maksājums tika veiksmīgi apstrādāts. |
clip_payment_request_id |
Maksājuma saites identifikators Clip. |
clip_receipt_no |
Clip čeka numurs. |