Kijan pou m entegre MonCash nan yon sit entènèt pou resevwa peman?

Question

Mwen gen yon ti boutik an liy e mwen vle kliyan yo ka peye ak MonCash. Kijan entegrasyon an mache an jeneral?

Accepted Answer

MonCash (Digicel) gen yon **API REST pou machann** ak yon anviwònman **sandbox** pou teste. Premye etap la se kreye yon kont biznis/machann pou jwenn `client_id` ak `client_secret`. Toujou verifye detay yo nan dokimantasyon ofisyèl la, paske URL ak chan yo ka chanje.

**Pwosesis la an jeneral:**
1. **Sèvè w** mande yon **token aksè** (OAuth2 *client credentials*) ak `client_id` ak `client_secret` ou.
2. **Kreye peman an**: voye `orderId` (ID inik kòmand ou) ak `amount`. API a retounen yon **token peman**.
3. **Redirije kliyan an** sou paj peman MonCash la ak token sa a. Li antre nimewo l ak PIN li **sou paj MonCash la**, pa sou sit ou.
4. MonCash **retounen kliyan an** sou URL retou ou konfigire a.
5. **Verifye peman an sou sèvè w**: rele API a pou rekipere tranzaksyon an pa `orderId` oswa `transactionId`, epi konfime **montan an** ak **estati a** anvan w livre.

**Règ sekirite:**
- `client_secret` la rete **sou sèvè a sèlman**, jamè nan JavaScript navigatè a.
- Pa janm fè konfyans paramèt URL retou a pou kont li: toujou **re-verifye ak API a** (etap 5).
- Sèvi ak yon `orderId` inik epi make kòmand lan "peye" **yon sèl fwa** (idempotans).
- Kenbe yon jounal (log) tout tranzaksyon yo pou rekonsilyasyon.

Gen bibliyotèk kominote (Node, PHP, Python) ki vlope API a. Li kòd yo anvan w itilize yo, paske se lajan ki an jwèt.

2 Repons