CardV pour Dujiao-Next

Obtenir votre clé API ↗

#Ce qu'il vous faut

Vous êtes le vendeur vis-à-vis de vos clients : vous fixez les prix, répondez à leurs questions et gérez leurs remboursements.

#Étape 1 : Obtenir votre clé API

Utilisez la clé API que vous avez déjà dans le Portail marchand, sous API et webhooks > Clés API. Vous n'avez pas besoin d'une clé distincte pour Dujiao-Next.

• Le key ID commence par ck_live_.
• Le secret de signature commence par cs_live_. Il ne s'affiche qu'une seule fois, à la création de la clé. Si vous ne l'avez plus, utilisez Régénérer le secret sur la clé. Le key ID reste le même, et l'ancien secret cesse de fonctionner immédiatement.

Les anciennes clés sans key ID ne peuvent pas être utilisées. Créez plutôt une nouvelle clé dans le Portail.

#Étape 2 : Ajouter la connexion

Dans l'administration Dujiao-Next, ouvrez Integration > Connection Management > New Connection et remplissez le formulaire :

Le taux de change et la marge se combinent ainsi : prix CardV × taux de change × (1 + marge), puis arrondi. Par exemple, avec un taux de 7.2 (simple exemple ; saisissez le taux actuel que vous avez relevé) et une marge de 15 %, une carte à 5.78 USD est vendue 47.9.

Quand le taux de change évolue, mettez-le à jour sur la connexion et cliquez sur Reapply Markup pour mettre à jour les prix des produits déjà importés. Faites de même quand vous changez la marge.

#Étape 3 : Tester la connexion

Cliquez sur Ping sur la connexion. Ping succeeded signifie que votre clé fonctionne, et le statut de la connexion passe à Active. Si une erreur s'affiche à la place, consultez Dépannage.

#Étape 4 : Importer des produits

1. Ouvrez Integration > Product Mappings > Import from Upstream et choisissez votre connexion CardV.
2. Parcourez par catégorie, ou passez en Flat List pour choisir des produits un par un.
3. Choisissez une catégorie locale, ou cochez Auto-create local categories. Un produit doit avoir une catégorie pour pouvoir être enregistré.
4. Importez. Chaque produit conserve son titre, sa description, ses instructions d'utilisation et ses valeurs faciales (comme 10 USD).

Les produits importés ne sont pas mis en vente. Vérifiez chacun d'eux, puis activez Active dans l'éditeur de produit.

#Étape 5 : Limiter à un article par commande

Pour chaque produit importé, ouvrez l'éditeur de produit et réglez Max purchase quantity sur 1.

CardV livre un article par commande. Si un client paie deux codes dans une même commande, CardV refuse l'achat et vous devez régler cette commande à la main. Dujiao-Next ne peut pas recevoir cette limite de CardV automatiquement : réglez-la donc vous-même.

Tant que vous êtes dans l'éditeur, nous vous recommandons aussi :

• Affichage du stock en boutique : choisissez Hide quantity. CardV achète auprès de la marque quand une commande arrive, donc le stock affiché par votre boutique signifie seulement « disponible ».
• Images : ajoutez les vôtres si un produit n'en a pas.

#Fonctionnement de la livraison

1. Le client paie dans votre boutique.
2. Votre boutique envoie l'achat à CardV, et CardV débite votre solde CardV.
3. Votre boutique interroge la commande chez CardV. Lors de nos tests, le code est arrivé en moins d'une minute.
4. Le code s'affiche sur la page de commande du client sous la forme Code, PIN (si la carte en a un) et Expires (si la carte a une date d'expiration). C'est toujours un code, jamais un lien.

Recharges directes. Certains produits sont crédités directement sur le compte de jeu ou d'application du client. Au paiement, le client renseigne les informations demandées par le produit, comme un ID de joueur ou un numéro de téléphone. Une fois la recharge effectuée, la page de commande du client affiche Top-up completed.

Si CardV ne peut pas livrer. CardV rembourse la commande sur votre solde CardV, et votre boutique marque l'achat comme annulé. Vous remboursez ou aidez ensuite le client dans votre boutique.

#Ce qui n'est pas disponible

La liste d'import n'affiche que les produits que votre boutique peut vendre via cette connexion :

• Valeurs faciales fixes uniquement. Les cartes dont le client saisit lui-même le montant ne sont pas listées.
• Non listés : recharges de crédit mobile, produits de paiement et portefeuilles, crypto et cartes de paiement prépayées.
• Codes uniquement. Les produits qui ne peuvent être livrés que sous forme de lien ne sont pas listés.

Les prix affichés sont vos propres prix CardV en USD.

#Liste d'IP autorisées

Si vous avez défini une liste d'IP autorisées dans le Portail marchand, ajoutez l'adresse IP publique du serveur qui héberge votre boutique Dujiao-Next. Sinon, CardV refuse toutes ses requêtes. La même clé, la même liste d'IP et les mêmes limites de requêtes s'appliquent à l'API CardV et à Dujiao-Next.

#Dépannage

Ces messages s'affichent dans l'administration Dujiao-Next, après Ping, pendant l'import ou sur un achat dans Procurement Orders.

#FAQ

Ai-je besoin d'une nouvelle clé API pour Dujiao-Next ? Non. Utilisez la clé API signée que vous avez déjà. Si vous utilisez aussi cette clé pour votre propre intégration de l'API CardV, les deux partagent les mêmes limites de requêtes.

Pourquoi laisser la Callback URL vide ? CardV n'envoie pas de callbacks aux boutiques. Votre boutique Dujiao-Next interroge chaque commande d'elle-même jusqu'à ce que le résultat soit définitif.

Que se passe-t-il quand les prix CardV changent ? Avec Auto-update price on sync activé, vos prix de vente sont recalculés avec votre taux et votre marge à la synchronisation suivante. S'il est désactivé, votre boutique continue de vendre à l'ancien prix.

Où voir ces commandes chez CardV ? Sur la page Commandes du Portail marchand. La colonne Votre ID de commande commence par dujiao: suivi du numéro de sous-commande Dujiao-Next (par exemple dujiao:DJ…-01). Si vous avez configuré des webhooks CardV, ils se déclenchent aussi pour ces commandes.

Puis-je modifier les titres, descriptions et images des produits ? Oui. La synchronisation met à jour les prix et la disponibilité. Elle n'écrase pas vos titres ni vos images.

Puis-je vendre des montants libres ? Pas encore via Dujiao-Next. Seules les valeurs faciales fixes sont disponibles.

#Support

Écrivez à [email protected] en indiquant votre Merchant ID, le numéro de commande Dujiao-Next et le message d'erreur. Votre utilisation de CardV est régie par nos Conditions d'utilisation.