Configurer le paiement hébergé.
Commencez par l'URL de l'identifiant marchand et ajoutez les paramètres de requête nécessaires.
https://app.inprimepay.com/
#/cpl/{MERCHANT_ID}
?amount=150.00
&name=Cliente%20S.p.A.
&type=installments
Intégrez le paiement via Inprimepay grâce à la page de paiement hébergée, les chaînes de requête, la génération de liens de paiement personnalisés serveur à serveur et les webhooks POST. Vous pouvez préremplir la page de paiement, générer un jeton en temps réel et valider les notifications avec des signatures HMAC-SHA256.
const caisse = "https://app.inprimepay.com/#/cpl/{MERCHANT_ID}" + "?montant=150.00" + "&name=Customer%20S.pA" + "&description=Facture%20%23001" + "&type=installments" + "&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback"; window.location.href = checkout;
La documentation propose deux modes complémentaires : une intégration low-code basée sur les URL Hosted Checkout et une génération dynamique serveur à serveur via OpenAPI.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}.pay_now, installments o subscription.callback_url peut inclure des paramètres personnalisés tels que order_id o reference.X-Api-Key.X-InPrimePay-Signature.Configurez le paiement hébergé, générez un lien de paiement personnalisé depuis votre serveur si nécessaire et recevez une notification de transaction asynchrone.
Commencez par l'URL de l'identifiant marchand et ajoutez les paramètres de requête nécessaires.
https://app.inprimepay.com/
#/cpl/{MERCHANT_ID}
?amount=150.00
&name=Cliente%20S.p.A.
&type=installments
Envoyez une requête POST au point de terminaison OpenAPI en utilisant votre secret Webhook dans l'en-tête X-Api-Key.
POST /api/custom-payment-links/ openapi/generate X-Api-Key: {WEBHOOK_SECRET} Content-Type: application/json
Une fois le paiement effectué, vous recevrez une requête POST contenant l'événement payment.succeeded et une signature HMAC-SHA256.
événement : paiement réussi en-tête : X-InPrimePay-Signature
Redirigez le client vers l'URL de paiement sécurisée et transmettez les données via les chaînes de requête pour une intégration rapide et facile à faible code.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}
amount100.50Si spécifié, le champ correspondant est prérempli et désactivé.
nameCliente%20S.p.A.Si spécifié, le champ est prérempli et désactivé.
descriptionFattura%20%23A12Pré-remplissez le motif, qui pourra ensuite être modifié par l'utilisateur.
typepay_now, installments ou subscription.
callback_url?order_id=12345
o reference: sont automatiquement extraits et renvoyés dans la charge utile du webhook.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}?amount=150.00&name=Cliente%20S.p.A.&description=Fattura%20%23001&type=installments&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback
Pour chaque nouvelle commande, vous pouvez utiliser le point de terminaison OpenAPI. L'authentification s'effectue via votre secret Webhook, que vous trouverez dans votre profil de plateforme.
POST https://api.inprimepay.com/api/custom-payment-links/openapi/generate
application/json
99.00.
Clé X-Api: {SECRET_WEBHOOK} Content-Type: application / json { "montant": 99.00, "nom_client": "Client SpA", "la description": « Acheter un service premium » }
{
"jeton":
"d7a8e2b1-4f4c-11eb-ae93-0242ac130002"
}
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}?token=d7a8e2b1-4f4c-...&callback_url=https%3A%2F%2Fmerchant-site.com%2Fcallback%3Forder_id%3D12345
Une fois la transaction terminée, le serveur Inprimepay envoie une notification POST asynchrone au point de terminaison spécifié dans la fonction de rappel.
payment.succeeded.
eventId, chargeId, sessionId, customerId e orderId.
callback_urlcomme order_id, peut être renvoyé dans la charge utile.
{
"un événement": "paiement.réussi",
"eventId": "a1b2c3d4-e5f6-7890-1234-56789abcdef0",
"horodatage": 1696772400,
"chargeId": 14592,
"sessionId": "cs_test_a1b2c3d4...",
"customerId": "{MERCHANT_ID}",
"orderId": "12345",
"montant": 100.50,
"devise": "eur",
"statut": "Succès",
"marchand": « Rémunération InPrime »,
"horodatage d'origine": "2024-05-13T10:35:42Z",
"mode de paiement": "carte"
}
Pour vérifier que la notification POST provient légitimement des serveurs d'Inprimepay, la requête inclut une signature de validation.
X-InPrimePay-Signature
chargeId Il est indiqué dans le guide comme étant unique et stable.
Le guide technique ci-joint décrit la sécurité, les méthodes disponibles, la rapidité d'intégration et la fiabilité de l'infrastructure.
Le flux Hosted Checkout + webhook peut être utilisé sur plusieurs points de contact numériques et de vente au détail sans modifier la logique d'intégration.
Générez un processus de paiement directement depuis votre ERP, CRM ou logiciel vertical et enregistrez le résultat dans votre flux via un webhook.
Intégrez le paiement à un processus d'application tout en conservant l'interface de paiement dans l'environnement Inprimepay.
Intégrez les paiements immédiats, les paiements échelonnés et les abonnements dans un processus de paiement propriétaire sans avoir à créer la page de paiement.
Générez des paiements à partir de bornes interactives, d'écrans tactiles et d'autres flux physiques connectés à des systèmes logiciels.
Créez une page de paiement avec le montant et le motif déjà renseignés et redirigez le client vers le paiement depuis un point de contact du magasin.
Utilisez le type subscription dans les flux où la configuration du marchand et du fournisseur prend en charge les paiements récurrents.
https://api.vostrosito.it/callback/payments.
X-Api-Key et pour la validation HMAC de la signature du webhook.
Les réponses essentielles concernant l'intégration, y compris les spécificités ajoutées par le Guide technique partenaire.
L'accès à la solution via l'API Inprimepay est gratuit. Les frais liés aux services et aux prestataires de paiement utilisés restent applicables.
Non. L'intégration utilise un système de paiement hébergé Inprimepay : votre système génère le lien et redirige le client vers l'URL de paiement.
https://app.inprimepay.com/#/cpl/{MERCHANT_ID}.
Oui. Les paramètres amount e name Elles peuvent être transmises via les chaînes de requête et, si elles sont présentes, elles sont précompilées et rendues non modifiables.
La documentation comprend pay_now,
installments e subscriptionLa disponibilité effective des méthodes concernées dépend des services activés par le commerçant.
Oui. Le guide précise que callback_url peut inclure des paramètres personnalisés tels que order_id o reference; sont automatiquement extraits et renvoyés dans la charge utile du webhook.
Publier un message sur
https://api.inprimepay.com/api/custom-payment-links/openapi/generate
en utilisant le secret du webhook dans l'en-tête X-Api-Key e
Content-Type: application/json.
amount e clientName sont indiqués comme obligatoires ;
description Ceci est facultatif. La réponse renvoie un jeton unique.
Réussir un callback_url Une fois la transaction terminée, le serveur Inprimepay envoie une notification webhook POST asynchrone. L'événement indiqué dans le guide est : payment.succeeded.
Calculez le HMAC-SHA256 du corps de la requête JSON brute en utilisant votre secret Webhook et comparez le résultat hexadécimal avec l'en-tête.
X-InPrimePay-Signature.
Oui. Le guide technique des partenaires indique que chargeId
Il est unique et stable.
Oui. Le modèle de paiement hébergé avec webhook convient également aux systèmes de gestion, aux applications, aux plateformes, au commerce électronique personnalisé et aux flux de vente au détail.
Le paiement hébergé, les paramètres de requête, la génération de transactions serveur à serveur, les jetons, les webhooks POST et la validation HMAC-SHA256 sont disponibles. Pour toute assistance technique : assistenza@inprimepay.com.
