MobupayMobupay
Chargement de vos clés API…

Créer un lien d'enregistrement de carte

POSThttps://api.mobupay.nc/api/v1/customers/{id}/card-links

Ce que fait cet appel

Crée un lien d'enregistrement de carte à transmettre au client. Contrairement à une session, ce lien vit plusieurs jours : la session sécurisée n'est ouverte qu'au moment où le client l'ouvre. C'est ce qu'il faut pour envoyer une invitation par e-mail ou par message ; une session, elle, ne vaut que quatorze minutes et convient au mode intégré, où le composant est monté immédiatement. Aucun montant n'est débité : la carte fait l'objet d'une vérification au montant zéro. Au retour, le client atterrit sur la page d'issue Mobupay, qui lui dit ce qui vient de se passer.

En-tête d'authentification
Authorization: Bearer sk_test_XXXX

Le pool est déduit du préfixe de la clé

Il n'y a pas d'interrupteur test et production sur cette page. sk_test_* ne traite aucun paiement réel, sk_live_* encaisse.

Paramètres

1 en-tête
idstringRequispath

Identifiant du client (`cus_*`), ou triple identification via `email` / `externalId` dans le corps.

Corps de la requête

application/json
purposestringOptionnel

`register` : le client enregistre une carte. `manage` : il consulte et gère celles qu'il a déjà. Défaut `register`.

expiresInintegerOptionnel

Durée de vie du lien, en secondes. De 900 (15 min) à 7 776 000 (90 jours). Défaut 604 800 (7 jours).

emailstringOptionnel

Identifie le client par e-mail si `:id` n'est pas précis. Triple identification.

externalIdstringOptionnel

Identifie le client par identifiant externe. Triple identification.

Codes de retour

201

Lien créé.

404

Client introuvable.

Langage

Requête cURLpostExemple
1curl --request POST \
2 --url https://api.mobupay.nc/api/v1/customers/{id}/card-links \
3 --header 'authorization: Bearer sk_test_XXXX' \
4 --header 'content-type: application/json' \
5 --data '{ "purpose": "register", "expiresIn": 604800 }'
Réponse

Cliquez sur Essayer pour lancer la requête et voir la réponse ici. Ou choisissez un exemple :

application/json