API & partenaires

Intégrez l'encaissement
dans votre logiciel

Une intégration REST donne à vos utilisateurs les trois modes d'encaissement — en ligne, sur smartphone, sur terminal. Le sandbox est disponible dès l'inscription, et vous touchez une commission récurrente sur chaque paiement encaissé par vos marchands.

Clés de test immédiates, sans validation commerciale préalable.

PHPNode.jsPythonJavaREST / cURL
Endpoints

Une API REST, trois modes d'encaissement

Vous créez un paiement avec le même objet, qu'il soit encaissé en ligne, sur un téléphone ou sur un terminal. Les webhooks signés vous notifient chaque changement d'état.

POST/v1/paymentsCréer un paiement — en ligne, terminal, lien ou QR
GET/v1/payments/{id}Statut et cycle de vie complet d'une transaction
POST/v1/refundsRemboursement partiel ou total, routé vers le bon canal
POST/v1/payment-linksGénérer un lien de paiement avec expiration
GET/v1/transactions?from=…Export et réconciliation, TVA par ligne
POST/v1/terminals/{id}/chargeDéclencher un paiement sur terminal physique
Webhooks

Signés, fiables, idempotents

Chaque événement déclenche un webhook signé HMAC-SHA256. Votre backend valide la signature avant tout traitement — retry automatique si vous ne répondez pas.

  • Signature HMAC-SHA256 sur chaque payload
  • Retry automatique avec backoff exponentiel
  • Idempotence garantie par payment_id unique
  • Vous vous authentifiez par clés API : une paire de test, une paire de production, révocables depuis votre espace.
  • Traces et logs de debug dans le dashboard
Webhook — payment.succeededsigné
{
  "event": "payment.succeeded",
  "payment_id": "np_7k2xQ9",
  "amount": 32000,
  "channel": "payment_link",
  "signature": "hmac-sha256=…"
}
→ votre backend valide, confirme la commande
Mise en route

De la première requête à la production

1
pk_test_… / sk_test_…

Créez votre compte développeur

Vous récupérez vos clés de test et vous lancez votre premier appel dans la journée.

2
simulate: success · declined · timeout

Intégrez et testez

Vous branchez les webhooks et déroulez vos parcours en sandbox. Notre équipe technique répond à vos questions d'intégration.

3
pk_live_… ✓ go-live

Passez en production

Nous validons votre intégration avec vous, puis vos marchands encaissent.

Programme partenaires

Chaque paiement de vos marchands
vous rémunère

Vous touchez une commission récurrente sur le volume encaissé par les marchands que vous avez intégrés. Elle est visible en temps réel dans votre espace partenaire et versée automatiquement chaque mois.

  • Le programme est contractualisé : la part, le mode de calcul et le versement figurent dans la convention partenaire.
  • Vous suivez votre volume et vos commissions marchand par marchand.
  • Vos clients gardent un compte Nextepay à leur nom ; vous gardez la relation produit.
Espace partenaire3 marchands actifs
Boutique Martin     12 480 €  +124,80 €
Café Central         8 920 €  +89,20 €
Studio Dupont        3 640 €  +36,40 €

— commissions du mois —
Total               250,40 €
Versement automatique le 1er du mois
Sandbox gratuit

Vos clés de test en quelques minutes

Vous créez votre compte, vous récupérez vos clés sandbox et vous lancez votre premier appel dans la journée. Pour le programme partenaires, un échange technique et commercial se planifie en une semaine.

Consulter la documentation Contacter notre équipe