Ce lien redirige généralement l'utilisateur vers une page de paiement MyPVit où il finalise la transaction.
Comportement selon le service
WEB (Airtel Money / Moov Money)
- Le lien redirige vers une page de paiement web.
- Le champ customer_account_number est optionnel.
- Service destiné aux navigateurs (mobile ou desktop).
VISA_MASTERCARD
- Le lien ouvre un formulaire Visa/Mastercard sur MyPVit.
- Le champ customer_account_number est requis (identifiant client/carte).
- Utilisé pour des paiements bancaires en ligne.
RESTLINK
- Le lien ne redirige pas vers une page web.
- À l'ouverture, un prompt de mot de passe s'affiche directement sur le téléphone du client.
- Le champ customer_account_number est requis.
- Idéal pour des intégrations mobiles silencieuses.
Récapitulatif des champs obligatoires
| Service | Redirection | customer_account_number | Comportement |
|---|---|---|---|
WEB | Oui | Non | Redirection vers une page de paiement MyPVit |
VISA_MASTERCARD | Oui | Oui | Redirection vers un formulaire bancaire |
RESTLINK | Non | Oui | Prompt de mot de passe sur le téléphone |
Cas d'usage
- Envoyer un lien de paiement à l'utilisateur
- Permettre le paiement en 1 clic depuis un site marchand
- Afficher un formulaire Visa/Mastercard
- Déclencher une demande USSD directe (RESTLINK) sans page web
En-têtes
Méthode
POSTUrl de base
https://api.mypvit.proChemin
/{codeUrl}/linkEncodage
Form URL Encoded (application/x-www-form-urlencoded)En-têtes requis
Content-Type: application/jsonX-Secret: sk_live_xxxX-Callback-MediaType: application/json (optionnel)
À propos de X-Callback-MediaType
Spécifie le format du callback envoyé par MyPVit en fin de transaction.
- `application/json` (par défaut)
- `application/xml` (si souhaité)
Cet en-tête s'applique uniquement aux transactions de type PAYMENT.
Exemples
Exemple de requête : service WEB
{
"agent": "AGENT 1",
"amount": 200,
"product": "PRODUIT TEST",
"reference": "REF13090141",
"service": "WEB",
"callback_url_code": "1B9LW",
"merchant_operation_account_code": "ACC_6661B5664CD2F",
"transaction_type": "PAYMENT",
"owner_charge": "CUSTOMER",
"operator_owner_charge": "MERCHANT",
"free_info": "Free info",
"failed_redirection_url_code": "JDCEY",
"success_redirection_url_code": "TKO7A",
"customer_account_number": "07XXXXXXX"
}Exemple de requête : service VISA_MASTERCARD
{
"service": "VISA_MASTERCARD"
}Exemple de requête : service RESTLINK
Ce mode ne redirige pas ; il déclenche un prompt immédiat sur le téléphone.
{
"service": "RESTLINK"
}Exemple de réponse
{
"status": "SUCCESS",
"status_code": "200",
"merchant_reference_id": "REF050125000356",
"url": "https://api.mypvit.pro/transaction-link/XYZ/payment"
}