Aller au contenu principal
NewChargeback Protection + Fee Intelligence for high-volume merchants. Get a savings analysis and a review of your dispute handling.See how it works
Détails

Chargeback Protection + Fee Optimization

See how it works: high-volume merchants get automated dispute evidence, interchange optimization, and real-time savings visibility.

See how it works
Fee Check

PLATEFORME DÉVELOPPEUR

API RapidCents

Les API RapidCents constituent la surface programmable de la plateforme : des ressources REST pour les paiements, les remboursements, les clients, les données enregistrées, les jetons et les règlements, en HTTPS avec des corps JSON. Ce sont les mêmes interfaces qu'utilisent le tableau de bord, la page de paiement hébergée et les champs intégrés, si bien qu'une vente prise au terminal, par lien de paiement ou depuis votre code devient le même type d'enregistrement. Quatre garanties tiennent partout : des clés cloisonnées par environnement, l'idempotence, des codes d'erreur typés et un webhook signé.

  • Sandbox avec cartes test
  • Webhooks signés
  • Erreurs typées et idempotence
  • Support développeur dédié
Demander un accès sandboxS'inscrire
Espace de requête et réponse API RapidCents avec terminal test et tableau de bord marchand
Une requête API RapidCents et sa réponse sur un poste développeur, avec le tableau de bord marchand et un terminal de test.

Ce qui passe sur le fil

  • Où elles se situent

    Sous tout le reste. Votre serveur les appelle directement; Rapid.js les atteint avec une clé publiable pour créer un jeton; une vente au terminal et un remboursement au tableau de bord aboutissent aux mêmes enregistrements. Un compte, un coffre, une vue de règlement.

  • Ce que vous envoyez

    Un corps JSON, une clé secrète, la version d’API fixée et une clé d’idempotence dès qu’il y a mouvement d’argent. Montant, devise, référence du moyen de paiement et votre propre référence de commande suffisent à la plupart des appels; la référence nomme chaque champ.

  • Ce qui revient

    La ressource et son état, avec un identifiant de requête. Lisez l’état plutôt que de présumer qu’un 2xx vaut approbation, et conservez l’identifiant : c’est le seul moyen de retracer une tentative ensuite.

Quand l’utiliser

  • Construire votre propre checkout

    Quand l’étape de paiement doit vivre dans votre produit et suivre vos règles de panier, de taxes, d’acomptes ou d’expédition partielle.

  • Automatiser les opérations

    Remboursements, fiches clients et moyens enregistrés sont adressables : ce qui se ferait à la main au tableau de bord peut s’exécuter sur un calendrier.

  • Alimenter les systèmes financiers

    Les ressources de règlement exposent le lot, les frais et le dépôt : l’écriture comptable se fait sur de l’argent réellement arrivé plutôt que sur une autorisation.

Mettre en œuvre API RapidCents

  1. Obtenez des identifiants sandbox et fixez explicitement une version d’API dans votre client.

  2. Créez un paiement côté serveur avec une clé d’idempotence dérivée de l’opération.

  3. Enregistrez un point de terminaison webhook et vérifiez les signatures avant d’agir.

  4. Associez chaque code d’erreur typé à une action, les codes inconnus échouant par défaut.

  5. Rapprochez sur les enregistrements de règlement, puis passez aux clés de production.

Ce qui échoue, et comment vous l’apprenez

  • Prendre le code HTTP pour le résultat

    Un appel peut réussir alors que le paiement est refusé. C’est l’état dans le corps qui répond : lire le seul code mène à expédier des commandes refusées.

  • Interroger au lieu d’écouter

    Relire un paiement pour voir s’il a changé est plus lent que le webhook, plus lourd pour vos limites, et manque quand même les remboursements et contestations nés ailleurs.

  • Des clés d’idempotence mal dérivées

    Une clé liée au client ou à la session fusionne deux achats réels en un seul. Dérivez-la de l’opération, conservez-la avec votre enregistrement et ne la réutilisez que pour relancer cette tentative.

  • Rapprocher sur les autorisations

    Les autorisations expirent, s’annulent et se capturent partiellement. Un processus financier bâti dessus contredit la banque; un processus bâti sur les règlements, non.

Sandbox par rapport à la production

  • La même surface, sans conséquence

    Le sandbox expose les mêmes ressources et les mêmes schémas. Ce qui change : le résultat suit la carte test, le règlement est comprimé et rien de tout cela n’est de l’argent.

  • Les limites s’appliquent quand même

    Le sandbox n’est pas un banc de charge. Les limites y existent : une suite de tests trop insistante rencontrera la même réponse de limitation que votre code de production doit traiter.

  • La disponibilité vise la passerelle

    L’API de la passerelle porte un niveau de service de 99,9 % en production. Le sandbox sert au développement et n’est pas l’environnement visé par cet engagement.

Questions sur API RapidCents

Que font les API RapidCents que le tableau de bord ne fait pas?

Tout ce que fait le tableau de bord, sur un calendrier et à grande échelle, plus ce que votre produit doit posséder : un checkout qui suit vos règles de panier, des remboursements déclenchés par votre logistique et des exports au format de votre grand livre.

Faut-il deux intégrations pour le en ligne et le en personne?

Non. Terminal, checkout hébergé, lien de paiement et API aboutissent au même compte et aux mêmes enregistrements : rapports, remboursements et rapprochement forment une seule intégration.

Comment éviter un double débit après un délai d’attente réseau?

Envoyez une clé d’idempotence sur la requête initiale et réutilisez exactement la même à la relance. Le second appel renvoie le premier résultat au lieu de créer un second paiement.

Puis-je stocker des numéros de carte pour garder le contrôle?

Vous pouvez conserver un jeton, et c’est ce qu’il faut faire. Publier des données de carte brutes place vos systèmes dans l’évaluation PCI la plus large; tokeniser par une surface hébergée garde la carte hors de votre environnement.

Comment savoir vite qu’un changement d’API me touche?

Fixez votre version, dirigez le journal des modifications vers un canal réellement lu et consignez la version envoyée par chaque service. Ces trois gestes transforment une rupture en billet planifié.

Où trouver les limites de débit et les noms de champs exacts?

Dans la référence API, par point de terminaison. Cette page décrit la forme de la surface et ses garanties; la référence est le contrat et fait foi.

Comment savoir qu'un paiement a été réglé et pas seulement autorisé?

Consultez les ressources de règlement plutôt que l'autorisation. Elles exposent le lot, les frais déduits et le dépôt, ce qui permet d'écrire une écriture comptable sur de l'argent réellement arrivé. Les autorisations expirent, s'annulent et se capturent partiellement : un processus financier fondé sur elles finit en désaccord avec la banque.

Que doit faire mon code devant un code d'erreur inconnu?

Échouer en position fermée. Associez chaque code d'erreur typé connu à une action précise et traitez tout code inconnu comme un échec plutôt que comme une réussite par défaut. Un nouveau code apparaissant en production doit interrompre l'opération et déclencher une alerte, pas emprunter une branche qui présume l'approbation.

Suite de l’intégration

Prochaine étape

Parlez à un spécialiste RapidCents

Fee Check de RapidCents lit un relevé de traitement et sépare l’interchange de la marge. Téléversez un relevé pour une analyse instantanée, ou ouvrez un compte marchand et commencez à encaisser sur un seul compte.

Vérifier mes fraisCommencer
  • Sans engagement
  • Spécialistes paiement au Canada
  • Téléversement sécurisé