Description de l'interface d'acceptation des paiements. PayMe4 - émettre une facture en ligne Émettre une facture pour un paiement par courrier ou par e-mail

Aujourd'hui, nous voudrions prêter attention à une telle méthode de collecte de paiement en ligne à l'aide de la carte bancaire d'un acheteur comme la mise en place d'un "lien vers le paiement" ou l'envoi d'une facture par e-mail. Ayant reçu un tel lien, l'acheteur clique dessus, se rend sur la page de paiement sécurisé du processeur de paiement électronique, saisit ses coordonnées bancaires et confirme le paiement en faveur du vendeur en cliquant sur le bouton "Payer".

Il convient de noter qu'il s'agit de la fonctionnalité la plus simple du lien de paiement. Les prestataires de services de paiement modernes ont depuis longtemps développé des options supplémentaires pour utiliser des liens pour leurs clients.

Si vous n'êtes pas une boutique en ligne et que vous ne disposez pas d'automatisation des ventes depuis le site, avant de choisir l'un ou l'autre prestataire de services de paiement, intéressez-vous aux possibilités de ce lien. Rappelez-vous, les détails comptent.

Méfiez-vous des systèmes archaïques, ils ralentissent votre processus de vente et vous font passer plus de temps à créer une facture et à la payer.

Le lien ne doit pas être unique. Ceux. vous devriez pouvoir le copier et le coller là où vous en avez besoin : sur le site Web, dans le code QR, sous le bouton "Acheter", envoyez-le à n'importe quel messager ou envoyez-le à plusieurs clients à la fois. Et définissez également un plan d'abonnement si vous vendez quelque chose par abonnement et que vous devez déduire automatiquement de l'argent de la carte de l'acheteur mensuellement et automatiquement.

Quel type d'entreprise est pratique pour générer des liens de paiement et émettre des factures aux clients

1. Une entreprise qui vend des services à des particuliers ou à des entrepreneurs individuels.

2. Entreprise avec une petite liste de biens / services - 10 à 20 articles. Puisque, pour recevoir un lien pour payer, vous devez créer chaque produit/service dans votre compte personnel.

3. Une entreprise qui n'a pas de "panier" sur le site, mais qui souhaite vendre des biens/services via le site en mode automatique, c'est-à-dire via le bouton "Acheter".

Comment le vendeur génère des liens de paiement dans le compte personnel bePaid

1. Entre dans le bureau du système bePaid

2. Crée un produit là-bas : entre son nom, sa description, son coût dans des champs spéciaux. Facultativement : définit la durée du lien ; le nombre de paiements pouvant être effectués via le lien ; fixe le montant et la fréquence de prélèvement automatique des fonds sur la carte du client après le premier paiement, si nécessaire.

4. L'insère sur le site sous le bouton "Acheter", dans une bannière, dans un code QR ou l'envoie à l'acheteur via des moyens de communication électroniques pratiques.

5. Après paiement par l'acheteur, reçoit une notification de paiement à l'adresse e-mail.

Comment l'acheteur paie

1. Clique sur le lien ou le bouton "Acheter" sur le site Web du vendeur et accède à la page de paiement sécurisé bePaid, où il voit le montant du paiement, le nom du vendeur. Il est invité à saisir les coordonnées de sa carte bancaire et à confirmer le paiement en cliquant sur le bouton « Payer ».

2. Après le paiement, reçoit une notification de paiement à l'adresse e-mail saisie lors du paiement.

Ce qu'il est important de considérer

L'acheteur ne peut payer qu'un seul service/produit par une procédure de paiement. En d'autres termes, pour que l'acheteur puisse acheter trois services/biens, il devra suivre le lien/cliquer trois fois sur le bouton "Acheter" et effectuer un paiement supplémentaire.

Et ici, il est important de comprendre que si vous vendez des billets de séminaire et supposez qu'un client peut acheter trois billets à la fois, la méthode de génération manuelle de factures ne vous convient pas. Ou si l'acheteur souhaite acheter un produit pour trois pièces, il devra cliquer trois fois sur le bouton d'achat et payer trois fois. Ce n'est pas confortable. Dans ce cas, il vous est tout de même recommandé de faire une intégration simple et d'installer un module de paiement pour le CRM de votre site.

Ces liens peuvent-ils être envoyés à des acheteurs étrangers ?

Peut! Acceptez les cartes VISA, MasterCard, BELKART de n'importe quelle banque, n'importe quel pays en BYN, RUB, USD, EUR. Ainsi que des cartes Halva.

Comment fonctionne le lien de paiement ? Certains des modèles les plus simples.

1. Si vous vendez des services et que le montant de la facture de chaque acheteur est individuel (consultation comptable, formation Skype, etc.)

Dans ce cas, vous écrivez des informations sur votre site Web sur la façon dont vous pouvez payer pour le service (les gestionnaires de bePaid envoient un exemple de texte aux clients).

Une fois que l'acheteur vous a contacté et a exprimé le souhait d'acheter un service, vous vous rendez dans l'espace de travail du système bePaid, saisissez les données relatives au service fourni dans les champs proposés : nom, montant, etc. Le système bePaid génère automatiquement un lien que vous pouvez facilement copier et envoyer au client par e-mail ou tout autre moyen de communication électronique.

2. Si vous vendez un service ou un produit directement à partir d'un site avec un prix fixe et que le client n'achète toujours qu'un seul produit ou service par paiement. Par exemple, payer un cours en ligne, une consultation personnelle, un accès au contenu, etc.

À côté de votre produit ou service, vous placez une description du coût du produit/service et un bouton "Acheter". Sous le bouton "Acheter" via le panneau d'administration de votre site, placez un lien vers le paiement que le système a généré dans votre compte bePaid.

L'acheteur, après avoir visité votre site, achète un produit ou un service sans appel supplémentaire à votre entreprise. Il clique sur le bouton "Acheter" et accède à la page de paiement pour saisir les données de la carte.

3. Si vous souhaitez vendre un produit ou un service à n'importe quel point physique à l'aide d'un code QR.

Vous créez simplement un produit dans votre compte personnel. Copiez le lien de paiement généré automatiquement et collez-le dans le code QR. À l'aide de l'application QR, votre client ouvrira un lien de paiement et sera redirigé vers une page de paiement sécurisée bePaid, où il sera invité à terminer le processus d'achat en saisissant les détails de sa carte bancaire.

Un code QR peut être créé sur n'importe quel site Web gratuit spécialisé dans les programmes QR. Certains programmes vous permettent d'ajouter un logo, des couleurs personnalisées et des statistiques de suivi.

4. Si vous vendez un produit ou un service pour une promotion et que vous devez suivre la quantité et le calendrier.

Lors de la création d'un produit dans votre compte personnel, vous pouvez définir un certain prix, combien de fois vous pouvez acheter ce produit à ce prix, et la durée de validité du lien de paiement (heures ou jours). Insérez le lien vers le site ou envoyez-le aux clients via des canaux de communication électroniques.

5. Si vous vendez un abonnement à n'importe quel contenu.

Dans votre compte personnel, vous pouvez configurer un plan d'abonnement : quand et à quelle fréquence prélever de l'argent sur la carte de votre client habituel. Par exemple, des frais de scolarité mensuels fixes pour une école de programmation en ligne.

Comment avoir la possibilité d'utiliser des liens "magiques" ?

Envoyez-nous une demande, et nous vous mettrons en relation pour accepter les paiements par cartes bancaires via Internet et créer votre compte personnel.

Sincèrement,
L'équipe bePaid

Nous connecterons votre entreprise pour accepter les paiements par cartes bancaires via Internet et au système ERIP.

Facture par email- une fonction qui permet au service du site d'envoyer des factures par e-mail. Vous n'avez plus besoin d'enregistrer les factures sur votre ordinateur local, puis d'ouvrir le courrier, de composer une nouvelle lettre et de joindre une facture en pièce jointe, maintenant tout cela est disponible avec "un seul bouton".

Comment envoyer une facture par e-mail ?

Il existe deux manières d'envoyer une facture par e-mail :

  • depuis la liste des comptes, pour cela, sélectionnez « Envoyer par e-mail » dans le menu contextuel ;
  • à partir du formulaire d'édition des comptes, acte, TORG-12 et factures, pour cela, cliquez sur le bouton "E-mail", qui se trouve au début et à la fin du formulaire.

Envoyer la facture par email

Avant d'envoyer la facture, il est nécessaire de cocher les documents nécessaires, ainsi que d'indiquer l'adresse e-mail du destinataire (À).

  • Par défaut, un document est marqué pour l'envoi. Il s'agit généralement de Compte si l'envoi provient d'une liste de comptes.
  • La liste des adresses e-mail des destinataires est extraite de la fiche de la Contrepartie. Pour ajouter ou modifier l'adresse e-mail du destinataire, vous devez apporter des modifications à la carte de contrepartie.
  • Vous pouvez également vous envoyer le document à vous-même, c'est-à-dire à votre adresse e-mail avec laquelle vous êtes inscrit au service.
  • Si nécessaire, les adresses e-mail peuvent être saisies manuellement, séparées par des virgules dans le champ "Saisir un autre e-mail".

L'adresse de l'expéditeur

  • Par défaut, l'adresse de l'expéditeur est l'adresse du service site web.

Comment changer l'adresse de l'expéditeur

Afin de pouvoir spécifier une adresse d'expéditeur différente, il est nécessaire d'activer l'option "Etendue" du service "Facture par e-mail". Voici à quoi ressemblera la fenêtre Envoyer un e-mail avec un champ de sélection d'expéditeur supplémentaire :

Cachet et signature

Lors de l'envoi d'un document par e-mail, l'apposition d'un sceau et d'une signature est sélectionnée par défaut. Si nécessaire, vous pouvez décocher cette case.

Aperçu

Avant l'envoi, vous pouvez visualiser tous les documents sélectionnés en cliquant sur le bouton Voir.

Pour envoyer les documents sélectionnés, cliquez sur le bouton Envoyer.

Capacités étendues

Connectez les fonctionnalités avancées de la fonction « Facture par e-mail », et vous pourrez :

  • Modifier l'adresse de l'expéditeur ;
  • Envoyer des e-mails via un serveur SMTP externe ;
  • Modifiez l'objet et le contenu de l'e-mail.

Pour PayPal, j'ai attrapé un étranger...

Je déclare en toute responsabilité à tous ceux qui se sont réunis pour des achats et des ventes dans la bourgeoisie : il n'y a rien à faire là-bas sans compte PayPal. Alors pendant un moment, "déballez" vos valises et familiarisez-vous avec ce système de paiement, auquel ce matériel est dédié.

Si un étranger se rendait sur notre RuNet pour faire du shopping, je lui conseillais de se procurer WebMoney. C'est-à-dire que PayPal est également mondial, car nous avons WMR ! Dans le même temps, même les ardents patriotes admettent que l'analogue étranger est plus simple et plus accessible que le nôtre.

Mais pourquoi ce système de paiement a-t-il réussi à devenir l'un des services les plus populaires ? Pour expliquer PayPal comme un "phénomène", voici quelques faits :

  • Fondée en 1998
  • En 2002, elle rejoint eBay.
  • Fonctionne dans 202 pays du monde.
  • Prend en charge les transactions avec 25 devises.
  • Plus de 200 millions d'utilisateurs sont enregistrés dans le système.
  • Disponible en Russie.
  • Vous permet de retirer de l'argent sur des cartes émises par des banques nationales.
  • Haut niveau de sécurité.

Traduit de l'anglais, PayPal signifie "camarade qui paie". Je pense que chacun de nous bénéficierait d'un tel ami☺.

  • Propre API.
  • Prise en charge de la plupart des concepteurs et CMS.


Comment utiliser

Je me souviens avec horreur comment j'ai souffert dans WebMoney alors que je n'étais pas encore un utilisateur avancé : inscription confuse, « malentendus » avec le retrait... Tout est beaucoup plus simple dans PayPal !


Pour retirer des roubles sur l'une des cartes jointes, accédez à la section "Aperçu". Ensuite, en bas à gauche, sélectionnez l'élément de menu "Retirer des fonds".


Je pense que vous connaissez maintenant bien PayPal et que vous avez trouvé en lui un ami qui paiera pour vous. C'est clair que de votre portefeuille, mais vous ne pouvez pas vous passer de ce camarade si vous allez faire du shopping «sur la colline»!

1. Régimes d'entreprise

L'interaction entre le système IntellectMoney, la boutique en ligne et l'utilisateur (acheteur) se produit comme suit :

  1. L'utilisateur (acheteur) remplit le formulaire de paiement (clause 4.2.1, tableau 2) sur le site Web de la boutique en ligne.
  2. La boutique en ligne envoie une demande de paiement au système IntellectMoney avec le transfert des données du formulaire de paiement et redirige l'utilisateur (acheteur) vers le site Web IntellectMoney.

    IntellectMoney demande à l'utilisateur (acheteur) de confirmer l'exactitude des données reçues.

    L'Utilisateur (Acheteur) confirme les données.

    Si l'Utilisateur (Acheteur) a choisi le paiement instantané, IntellectMoney accepte immédiatement le paiement de l'Utilisateur (Acheteur). Si le paiement différé est sélectionné, l'étape 5 est ignorée.

    IntellectMoney affiche un message sur l'achèvement de la procédure de paiement, redirige l'utilisateur (acheteur) vers le site Web de la boutique en ligne et informe de l'achèvement de la procédure de paiement ( URL de paiement réussie, point 4.1, tableau 1)

    Si le paiement différé est sélectionné, l'Utilisateur (Acheteur) paie de manière asynchrone l'achat effectué dans la boutique en ligne.

    Dans l'ordre de la file d'attente générale, IntellectMoney traite tous les paiements disponibles et informe de manière asynchrone la boutique en ligne du fait de la réception des fonds sur son compte ( URL de notification de paiement, point 4.2.1, tableau 2).

2. informations générales

Le système IntellectMoney.Merchant offre aux magasins en ligne (ci-après dénommés le vendeur) la possibilité de régler les achats des Utilisateurs (ci-après dénommés l'acheteur) de différentes manières, par exemple, à partir d'un compte dans le système IntellectMoney, par carte bancaire , transfert d'argent, terminal ou paiement bancaire.

L'acheteur passe une commande sur le site Web du vendeur, sélectionne le mode de paiement via IntellectMoney et se rend sur le site Web IntellectMoney.Merchant, où l'acheteur reçoit une facture de paiement (ci-après dénommée CCO) sur la base des données reçues du site Web du vendeur. . Chaque achat a une facture de paiement (ci-après dénommée CCO), il s'agit d'un numéro unique dans le système, commençant par 3 et composé de 10 chiffres et ayant une date d'expiration (maximum 6 mois à compter de la date de création) et le montant de l'achat.

Paiement de SCO

Le vendeur peut choisir quels modes de paiement seront disponibles pour l'acheteur. L'acheteur peut régler la SCO en plusieurs versements.

Si, après avoir crédité le paiement au SKO, celui-ci n'est pas entièrement confirmé, il est alors considéré comme partiellement confirmé. Le CCO partiellement confirmé peut être annulé par l'acheteur à partir du compte personnel ou du site Web du marchand. Lorsque le compte est annulé, tous les fonds crédités au SKO sont crédités sur le compte de l'acheteur. Si l'acheteur n'est pas enregistré dans le système, un compte est créé sur l'e-mail spécifié sur le site Web du marchand. Dans ce cas, l'acheteur peut utiliser le changement en s'inscrivant dans le système, en indiquant l'e-mail spécifié dans le SKO comme identifiant.

Si après avoir crédité le paiement au CKO, il reste des fonds, deux paiements sont créés, le paiement "final" est créé pour le montant du CCO, - il est crédité sur le compte du magasin moins la commission IntellectMoney, et le "change" est créé pour le montant du trop-perçu et crédité sur le compte de l'acheteur. Après avoir créé le paiement "final", le TCO devient confirmé. L'utilisateur peut continuer à effectuer des paiements à ce CCO, tandis que tous les fonds iront à la monnaie de l'acheteur.

Date d'expiration du SCO

RMS a une date d'expiration, c'est un paramètre que le vendeur envoie au site Web du marchand avec le montant de l'achat. Si le vendeur n'a pas dépassé la date d'expiration, alors IntellectMoney fixe la durée de vie du CCO à 6 mois à partir du moment où l'achat a été créé. Au moment de l'expiration du CCO, le CCO partiellement confirmé transfère tout l'argent à la monnaie de l'acheteur. Si le CCO a été gelé, tout l'argent est transféré sur le compte du vendeur moins la commission IntellectMoney.

Dans le cas où les fonds du payeur tombent dans le CCO annulé, les fonds tombent dans la monnaie du payeur.

holding

Le vendeur peut paramétrer le fonctionnement du DIS en mode « holding ». Pour configurer ce mode, il suffit de passer les paramètres HoldMode,expireDate et holdTime, et il faut aussi activez l'option "Accepter uniquement les ID d'achat uniques" dans les paramètres de la boutique.

Ce mode est utilisé pour geler le compte CCO. Fondamentalement, ce mode est pratique à utiliser si les utilisateurs de la boutique en ligne paient souvent avec des cartes bancaires. Après avoir émis le CCO en mode de retenue et payé depuis la carte bancaire, le montant sur la carte bancaire n'est pas débité, mais bloqué, le CCO lui-même, une fois le paiement intégral, ne changera pas d'état avant le temps de retenue défini, mais peut changer l'état à la demande du magasin. Ou annulez le SKO, auquel cas les fonds qui étaient sur le SKO seront restitués à l'utilisateur. Si la confirmation se produit, les fonds sont crédités au magasin.

Si le CCO est annulé par le magasin, le montant bloqué sur la carte bancaire est restitué et tous les autres fonds seront radiés en tant que monnaie. Par exemple, l'acheteur a écrit un CKO pour 100 roubles, il a payé 30 roubles depuis le terminal et il a payé le reste du montant avec une carte bancaire. Le magasin ou l'acheteur a annulé le CCO, 30 roubles seront crédités à l'acheteur en échange et 70 roubles seront restitués sur la carte bancaire. En cas de paiement du TRS par d'autres moyens que les cartes bancaires, lors de l'annulation du TKO, les fonds sont restitués sur le compte de l'utilisateur.

La date maximale de détention du SKO est de 119 heures (4 jours 23 heures) à partir du moment du paiement. Si le vendeur n'envoie pas de demande d'annulation ou de crédit du CCO au système IntellectMoney avant la date d'entrée en vigueur du CCO, le CCO sera automatiquement crédité sur le compte du magasin ou renvoyé automatiquement sur le compte de l'acheteur (selon le compte personnel) .

L'Utilisateur (Acheteur) sélectionne un produit dans la boutique en ligne, la boutique calcule le montant de la Commande et envoie une demande de paiement au système IntellectMoney. IntellectMoney accepte les paiements deUtilisateur (Acheteur) et informe la boutique en ligne de la réception du paiement.

Les paiements sont acceptés par le système IntellectMoney à l'aide d'un protocole de transfert de données sécurisé SSL.

Les interfaces du système IntellectMoney permettent aux boutiques en ligne de se renseigner instantanément sur les paiements acceptés, ainsi que sur le fait de recevoir des paiements différés.

3. La séquence de réception des paiements par le système IntellectMoney via une boutique en ligne

L'interaction entre le système IntellectMoney, la boutique en ligne et l'utilisateur (acheteur) se déroule comme suit :



  1. L'acheteur sélectionne un produit sur le site Internet de la boutique en ligne ;
  2. La boutique en ligne crée une commande (achat), génère et affiche un "formulaire de demande de paiement" que l'acheteur doit envoyer pour paiement dans IntellectMoney (clause 4.2.1, tableau 2, exemple 1).
  3. L'utilisateur (acheteur) se rend sur le site IntellectMoney, sélectionne un mode de paiement (parmi ceux spécifiés par le paramètre de préférence dans le « Formulaire de demande de paiement » (s'il est spécifié), ou parmi tous ceux possibles (s'il n'est pas spécifié). Saisie des données d'identification : E-mail, ou login/mot de passe (le cas échéant).
  4. Le système IntellectMoney crée une facture de paiement (CKO) sur la base des données reçues du « Formulaire de demande de paiement ».
  5. Les informations sur le CCO créé (exposé) et le mode de paiement sont affichées à l'acheteur.
  6. Le système IntellectMoney envoie une notification à la boutique en ligne concernant la création du CCO via le « Formulaire de notification de paiement » (clause 4.2.2, Tableau 3, Exemple 2) avec le champ paymentStatus = 3 (CCO créé).
  7. L'acheteur paie l'achat en utilisant l'une des méthodes disponibles.
  8. Si, lors de la création d'un achat, la boutique en ligne n'a pas spécifié (transmis) le paramètre holdMode dans le «Formulaire de demande de paiement», l'exécution continue à partir de l'étape 10, en créditant immédiatement les fonds sur le compte de la boutique en ligne.
    Sinon (le paramètre holdMode est défini), le système IntellectMoney envoie une notification à la boutique en ligne concernant la création du CCO via le « Formulaire de notification de paiement » (clause 4.2.2, Tableau 3, Exemple 2) avec le champ paymentStatus = 6 (le montant requis est bloqué sur le CCO, en attente de demande de débit ou de déblocage de fonds ou d'expiration de la période de blocage).
  9. La boutique en ligne envoie une demande au système IntellectMoney concernant une action avec des fonds bloqués via le "Formulaire de demande de crédit ou de déblocage de fonds" (clause 4.2.3, Tableau 4, Exemple 3) avec le paramètre action = Remboursement (pour débloquer des fonds (retour à l'utilisateur), ou ToPaid (pour créditer des fonds sur le compte de la boutique en ligne).
  10. Conformément à la demande reçue à l'étape 9, le système IntellectMoney crédite des fonds sur le compte de la boutique en ligne, ou annule le CCO et restitue les fonds à l'utilisateur.
    Si la boutique en ligne n'a pas envoyé de demande conformément à l'étape 9, après l'expiration du délai de blocage des fonds pour le CKO, le système IntelectMoney crédite automatiquement les fonds sur le compte de la boutique en ligne, ou restitue les fonds au utilisateur, en fonction des paramètres du magasin dans le compte personnel.
  11. Le système IntellectMoney envoie une notification à la boutique en ligne concernant le paiement du CCO, ou l'annulation (uniquement en cas de blocage de fonds) du CCO via le « Formulaire de notification de paiement » (clause 4.2.2, Tableau 3, Exemple 2) avec le champ paymentStatus = 5 (CCO entièrement confirmé, argent transféré sur le compte de la boutique en ligne), paymentStatus = 4 (CCO annulé, argent restitué à l'utilisateur), paymentStatus = 7 (CCO partiellement confirmé, dans ce cas le montant qui a déjà été confirmé sera transféré), paymentStatus=8 (CCO a été entièrement payé et il a été retourné).

4. Interfaces

4.1. Données d'enregistrement de la boutique en ligne

Avant d'accepter des données à l'aide du système IntellectMoney, en plus de s'inscrire dans le système, une boutique en ligne doit configurer un certain nombre de paramètres qui régissent la procédure d'acceptation des paiements et des notifications sur les modifications de l'état du paiement, ainsi que les informations présentées aux utilisateurs lors d'un achat. .

Pour un site de boutique en ligne, le système stocke son propre ensemble de valeurs. Page dans le compte personnel de la personne morale. visages pour modifier les paramètres, cliquez sur le lien "Modifier" de la boutique sélectionnée. Il est nécessaire de remplir les champs, ainsi que de sélectionner correctement le compte sur lequel les paiements seront crédités. Pour faciliter le test du protocole, vous devez sélectionner un compte avec une devise de test (tst.). Après un test réussi, vous devez passer à un compte en rouble.

La deuxième étape consiste à configurer le protocole IntellectMoney. Sur la page https://www.intellectmoney.ru/ru/enter/ps_organization_shop/ vous devez vous rendre dans les paramètres du protocole en cliquant sur le lien "IntellectMoney" à côté du magasin personnalisé. La liste des paramètres du protocole et leur objectif sont donnés dans le tableau 1 :

Tableau 1. Liste des paramètres de protocole

Le nom du paramètre

Format

Description

URL d'information sur le paiement (URL de résultat)

jusqu'à 512 caractères

URL (sur le site Web de la boutique en ligne) à laquelle le système IntellectMoney envoie des requêtes HTTP/S POST pour effectuer un paiement. Si la boutique en ligne n'a pas défini cette URL, elle ne sera pas notifiée par le système des paiements effectués.

L'URL doit commencer par le préfixe "http://" ou "https://".

Clef secrète

jusqu'à 32 caractères

Chaîne de caractères utilisée pour signer les données transmises par le système IntellectMoney au magasin. Cette chaîne est utilisée pour augmenter la fiabilité de la notification envoyée. Le contenu de la ligne n'est connu que du système IntellectMoney et de la boutique en ligne !

Envoyer la clé secrète à l'URL de résultat
(uniquement avec HTTPS)


Si une connexion sécurisée avec le magasin (https) est utilisée, vous pouvez utiliser la "clé secrète" comme certificat indiquant que les données ont été envoyées par IntellectMoney.

URL de retour

jusqu'à 512 caractères

L'adresse vers laquelle l'utilisateur (acheteur) sera redirigé après facturation si l'utilisateur a choisi un mode de paiement "hors ligne" (par exemple : bornes).

Mode débogage

Case à cocher

Il est recommandé de l'inclure au moment du développement du module qui implémente le protocole. Permet au développeur de recevoir des informations sur les erreurs dans une version étendue, avec des suggestions de solutions. Après avoir basculé le magasin en mode combat, désactivez l'option.

4.2. Formulaires HTML

Pour transférer des informations entre le site Web de la boutique en ligne et le système IntellectMoney, des formulaires HTML sont utilisés :

Formulaire de demande de paiement - généré par le site Web de la boutique en ligne pour générer une demande de création (émission) de CCO (factures à payer) pour payer l'achat dans le système IntellectMoney. Transmis via le navigateur Web de l'utilisateur (acheteur).

Formulaire de notification de paiement - généré par le système IntellectMoney pour informer la boutique en ligne de la création ou du changement du statut du CCO. La notification est transmise sans utiliser le navigateur Web de l'utilisateur (acheteur) au site Web de la boutique en ligne.

Formulaire de demande de crédit ou de déblocage de fonds - généré par la boutique en ligne pour demander le déblocage des fonds (retour à l'utilisateur), ou créditer des fonds sur le compte de la boutique en ligne dans le système IntellectMoney. Il est utilisé dans le cas où la date de blocage (détention) des fonds pour le SKO a été fixée lors de la création du SKO. La demande est transmise sans utiliser le navigateur Web de l'utilisateur (acheteur) au site Web d'IntellectMoney.

4.2.1. Formulaire de demande de paiement

Ce formulaire envoie une demande du site Web de la boutique en ligne au système IntellectMoney via le navigateur Web de l'utilisateur (acheteur). Il doit avoir les attributs et champs suivants :
action - https://merchant.intellectmoney.ru/ru/

méthode- POSTER, OBTENIR

Page de paiement multilingue Développer la source

Https://merchant.intellectmoney.ru/ru/ - Langue russe https://merchant.intellectmoney.ru/en/ - Langue anglaise https://merchant.intellectmoney.ru/de/ - Langue allemande https://merchant .intellectmoney.ru/fr/ - Langue française https://merchant.intellectmoney.ru/es/ - Langue espagnole https://merchant.intellectmoney.ru/pt/ - Langue portugaise https://merchant.intellectmoney.ru/ it/ - Langue italienne https://merchant.intellectmoney.ru/jp/ - Langue japonaise https://merchant.intellectmoney.ru/bg/ - Langue bulgare

Tableau 2.1 Champs du formulaire de demande de paiement

Nom

Nom du champ de formulaire HTML

Requis

Description

Identifiant du magasin

eshopId

Oui

https://www.intellectmoney.ru/ru/enter/ps_organization_shop/ dans la colonne "ID"

numéro de commande

Oui

Objet du paiement

Nom du service

Non

Somme

paiement

destinataireAmount

Oui

Le montant du paiement que la boutique en ligne souhaite recevoir de l'utilisateur (acheteur). La somme doit être supérieure à zéro, la partie décimale est séparée par un point, deux décimales après le point.

La longueur maximale est de 10 chiffres, décimales comprises.

Devise

paiement

devise du destinataire

Oui

Monnaie de paiement. Peut prendre des valeurs :

  • RUB et RUR - pour les paiements en roubles
  • TST - pour les paiements tests
  • USD - pour les paiements en dollars américains
  • EUR - pour les paiements en euros

Attention: USD et EUR peuvent être transférés seulement pour les paiements par carte bancaire (preference=bankCard). Vous pouvez obtenir des informations détaillées sur la connexion des devises étrangères auprès de votre responsable personnel.


Etc Les règles d'utilisation de la devise TST sont décrites dans ce article -

Attention!Lors de l'utilisation de devisesLes factures RUB et RUR ne peuvent être émises qu'à une adresse e-mail où l'organisation n'est pas enregistrée.

Nom d'utilisateur

nom d'utilisateur

Non

Nom d'utilisateur complet (acheteur). Saisie par l'utilisateur (acheteur).

Courriel de l'utilisateur

utilisateur_email

Non

E-mail de l'utilisateur (acheteur). Entré par l'acheteur.

La longueur maximale est de 255 caractères.

Adresse de paiement réussie

successUrl

Non

L'adresse vers laquelle l'utilisateur (acheteur) sera redirigé en cas de paiement réussi

La longueur maximale est de 512 caractères.

Adresse de retour à la boutique en ligne backUrlNon

L'adresse vers laquelle l'utilisateur (acheteur) sera redirigé en cas de clic sur le lien " Retour en magasin" sur la page de paiement

La longueur maximale est de 512 caractères.

Modes de paiement pour l'utilisateur - accédez directement à la page de saisie des détails

préférence

Non

Modes de paiement qui seront disponibles à la sélection lors du paiement de l'achat. Si un paramètre est spécifié, l'utilisateur sera redirigé vers la page de saisie des détails. (lors de la définition du paramètre bankCard et de la spécification de l'e-mail de l'utilisateur, l'utilisateur passera directement à la saisie du numéro de carte bancaire, et le compte sera déjà créé. Si l'e-mail n'est pas spécifié, l'utilisateur sera redirigé vers la page de saisie de l'e-mail)

Valeurs possibles (si plusieurs sont sélectionnées, elles sont séparées par une virgule) :

Paiement depuis le compte IntellectMoney - interne ;

Carte bancaire Visa/MasterCard - bankCard ;

Attention! Si vous passez une préférence ou un paramètre lmi_pay_method lors d'une demande de paiement, alors seuls les moyens de paiement transférés seront affichés, même si tous les autres sont activés. Par exemple, si vous passez préférence = BankCard, alors l'utilisateur sera immédiatement redirigé vers la page de saisie des détails de la carte. Si vous cliquez sur le bouton "Modifier le mode de paiement", l'utilisateur reviendra sur la page de sélection de paiement, mais seul le mode de paiement par carte bancaire sera affiché. .

Activer le mode maintien holdModeNon

Responsable de l'activation du mode de maintien, et peut prendre trois états :

  1. "1" - active le mode de maintien, dans ce cas, vous devez passer les paramètres expireDate et/ou holdTime
  2. "0" - désactive le mode de détention, les comptes ne seront pas bloqués
  3. "null" = ne pas passer ce paramètre - le mode de détention est défini dans le compte personnel

Il faut aussi inclure dans le paramètre "Accepter uniquement les ID d'achat uniques".

La période d'existence de l'OCS

date d'expiration

Non

Date et heure auxquelles il deviendra impossible de payer la facture dans le système IntellectMoney.

Transférer à format "aaaa-MM-jj HH:mm:ss".

Période de détention des fondsholdTimeNon

Le temps après lequel les fonds retenus (gelés) seront crédités sur le compte du magasin ou retournés à l'acheteur est mesuré en heures.

Un entier de 0 à 119 heures.

Vérifier les données
Reçu du marchandNon

Ce paramètre est requis pour les magasins avec paiement en ligne activé

Design compactcadreNonEn passant la valeur 1, la page de paiement s'affichera dans un design compact

Paramètres supplémentaires de la boutique en ligne

Non

Tous les champs de formulaire qui ont les préfixes "UserField_N", "UserFieldName_N" dans leurs noms (où N est un numéro de séquence) sont automatiquement traités par le système IntellectMoney et transférés sur le site Web de la boutique en ligne.

La longueur maximale de tous les champs supplémentaires au total est de 4000 caractères.
Plus d'informations sur les champs supplémentaires sont écrites dans la section :

Signature pour les données validées

hacher

Non

L'algorithme de génération est décrit dans la section .

Important : Pour les opérations planifiées, l'algorithme de génération de signature est décrit dans le " ".

Le paramètre est requis lors de l'activation de l'option "Require HASH" dans les paramètres du magasin.

Type d'opération récurrente

Le type d'opération récurrente prend une valeur - " Activer".

Avec cette commande, la carte est enregistrée dans la chaîne de paiement. De plus, pour toutes les transactions avec cette carte, vous devez transférer la facture payée (Invoice Number Payable) dans le champ récurrentSourceInvoiceId, le reste des opérations sur les factures est effectué automatiquement par le système sans participation de l'utilisateur. En passant ce paramètre, vous associez la carte avec laquelle l'acheteur a payé au numéro CCO pour lequel le paiement a été effectué.

Carte plastique ShortPan 2

courtPan

Le numéro court de la carte plastique (les quatre premiers et derniers chiffres de la carte plastique) avec laquelle la facture a été payée.

Pays 2

pays

Le pays dans lequel la carte plastique a été émise. 2

Banque émettrice 2

banque

La banque qui a émis la carte plastique. 2

Adresse IP 2

adresse IP

Adresse IP de l'utilisateur qui a effectué le paiement de la facture. 1

La clé secrète

clef secrète

Valeur Clé secrète connue uniquement de la boutique en ligne et du système IntellectMoney. Transmis si la fonctionnalité "Envoyer la clé privée" est activée. Ce champ sera vide si le paramètre "URL d'alerte de paiement" n'est pas sécurisé (en utilisant HTTP, pas HTTPS).

Signature de contrôle

hacher

La signature de contrôle de la notification de paiement, qui est utilisée pour vérifier l'intégrité des informations reçues et identifier de manière unique l'expéditeur.

L'algorithme de formation est décrit dans la section " ".

Options de la boutique en ligne

Déterminé par la boutique en ligne

Tous les champs soumis depuis le site Web de la boutique en ligne dans le "Formulaire de demande de paiement", ayant le préfixe "UserField_N", "NomChampUtilisateur_N" (où N est un numéro de série)

État de l'opération planifiée état récurrent

Affiche le statut de l'opération planifiée pour ce paiement.


Exemple 2

Formulaire de notification de paiement Développer la source

... ...

... ...
...

4.2.3. Formulaire de demande de crédit ou de déblocage de fonds

Ce formulaire est transmis par la boutique en ligne sans utiliser le navigateur Web de l'utilisateur (acheteur) au site Web IntellectMoney.

La demande est destinée à être utilisée si le blocage (détention) des fonds sur le SKO est utilisé. La demande ne peut être envoyée par la boutique en ligne qu'après réception alertes de paiement avec le statut d'achat (paymentStatus) = 6 (le montant requis est bloqué dans le SKO, une demande de débit ou de déblocage de fonds ou l'expiration de la période de blocage est attendue).

En réponse, le site Web IntellectMoney renvoie une chaîne D'ACCORD si la demande a réussi, ou une chaîne décrivant l'erreur dans le cas contraire.
Le formulaire doit avoir les attributs et champs suivants :

méthode- POSTE

Tableau 4. Champs fformulaires de demande de crédit ou de déblocage de fonds

Nom

Nom du champ de formulaire HTML

Requis

Description

Identifiant du magasin

eshopId

Oui

Le numéro du site de la boutique en ligne auquel l'utilisateur (acheteur) doit effectuer un paiement. visible sur la page https://www.intellectmoney.ru/ru/enter/ps_organization_shop/ dans la colonne "ID"

Numéro d'achat interne de la boutique en ligne

numéro de commande

Oui

Dans ce champ, la boutique en ligne précise le numéro d'achat conformément à son système comptable. Il est conseillé d'utiliser un numéro unique pour chaque paiement, ce qui vous permettra d'obtenir rapidement des informations relatives à celui-ci via le système IntellectMoney.

La longueur maximale est de 50 caractères.

Montant de la transaction Non

Le montant dont il est nécessaire d'effectuer l'opération de déblocage des fonds sur le CCO détenu, ou le montant dont le montant initial du CCO doit être réduit en cas de paiement partiel, ou le montant dont un remboursement doit être effectué pour le payé CCO.

Ce paramètre est passé uniquement pour débloquer des fonds en cas de CCO détenu, ou pour réduire le montant initial de CCO en cas de paiement partiel (action=Refund), ou lors d'un remboursement sur un CCO payé

Lorsque les fonds sont crédités (action=ToPaid) ou lorsque les fonds sont intégralement restitués, ce paramètre n'est pas passé.

Action demandée actionOui

Action à entreprendre auprès du CCO : Remboursement pour débloquer des fonds (pour un CCO détenu), pour restituer des fonds (pour un CCO payé) ou pour réduire le montant du CCO (pour un paiement partiel). Ou ToPaid pour créditer des fonds sur le compte d'une boutique en ligne (avec un SCO détenu).

Objet du paiement

Nom du service

Non

Description du produit ou du service. Formé par une boutique en ligne.

La longueur maximale est de 1024 caractères.

Nouveaux paramètres de réception Reçu du marchandNon

Données pour la formation d'un nouveau chèque dans la caisse en ligne.

Il est utilisé en cas de réduction partielle du montant du TRS ou de remboursement partiel du TRS (les paramètres action=Refund et operationAmount ont été passés) pour un magasin disposant d'une caisse enregistreuse en ligne connectée au système IntellectMoney. En cas de réduction partielle du montant de CRS, un nouvel accusé de réception doit être envoyé (c'est-à-dire les articles de marchandises pour lesquels le paiement sera effectué), dans le cas d'un retour partiel pour CRS, un accusé de réception doit être transmis (c'est-à-dire les positions des marchandises pour lesquelles un retour est effectué).

Signature pour les données validées

hacher

Non

La signature de vérification de la demande, qui est utilisée pour vérifier l'intégrité des informations reçues du magasin et identifier de manière unique l'expéditeur.

L'algorithme de génération est décrit dans la section "Contrôle de la signature des données de paiement". Requis uniquement si "Require HASH" est activé dans les paramètres du magasin.

La clé secrèteclef secrète

Dans le cas où la signature (hachage) n'est pas utilisée.

Exemple 3.1. Formulaire de demande pour créditer des fonds sur une boutique en ligne

... ...

..

Exemple 3.2. Formulaire de demande de libération de l'acheteur (remboursement) Développer la source

... ...

..

operationAmount- d Ce paramètre est utilisé en cas de paiement partiel de CKO, ou s'il est nécessaire de débloquer partiellement des fonds sur un CKO détenu, ou en cas de remboursement partiel de fonds lorsqu'un CKO est payé.

Cas 1:Un RMS retenu a été mis en place pour 30,00 roubles. L'acheteur a payé ce CCO avec une carte plastique, les fonds d'un montant de 30,00 roubles sont bloqués sur le compte de la carte plastique. Le magasin avait besoin de réduire le montant de RMS de 10,00 roubles. Le magasin envoie une requête avec les paramètres action=Refund et operationAmount=10.00. Après cela, 10,00 roubles sont débloqués sur le compte de la carte plastique de l'acheteur et le montant du SCO est réduit à 20,00 roubles.

Cas 2 :A été exposé au RMS habituel pour 30 roubles. Le client a partiellement payé le CCO pour un montant de 20,00 roubles. Le TCO est dans l'état "partiellement payé" et ne peut pas être crédité sur le compte du marchand. Le magasin envoie une requête avec les paramètres action=Refund et operationAmount=10.00. Le montant du SCO passe à 20,00 roubles. Le SCO passe à l'état "entièrement payé" et est crédité sur le compte du magasin.

Cas 3 :A été exposé au RMS habituel pour 30 roubles. Le client a payé intégralement le CCO d'un montant de 30,00 roubles. Le TCO est dans l'état "entièrement payé" et les fonds ont été crédités sur le compte du commerçant. Le magasin envoie une requête avec les paramètres action=Refund et operationAmount=10.00. Selon le CKO, les fonds sont restitués au payeur pour un montant de 10,00 roubles.


Exemple 3.3

Formulaire de demande de libération partielle (restitution) des fonds à l'acheteur Développer la source

... ...

..

Exemple 3.4

Transfert de fonds en langage de programmation PHP

Pour implémenter cet exemple, vous aurez besoin du package libcurl.

Exemple

"Votre numéro de magasin dans IntellectMoney", "orderId" => "Numéro de commande dans le système de boutique en ligne", "action" => "ToPaid", "secretKey" => "Clé secrète de la boutique dans IntellectMoney", "hash" => " créer un hachage", ] ; $URL = "https://merchant.intellectmoney.ru/ru/index.php" ; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $URL); curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US; rv:1.9.1.2) Gecko/20090729 Firefox/3.5.2 GTB5"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); $résultat = curl_exec($ch); curl_close($ch); print_r($résultat); ?>

4.3. Vérification des informations de paiement

Lors d'un paiement, le système IntellectMoney envoie une notification de paiement via " Formulaire de notification de paiement" sur " URL de notification de paiement" spécifié par la boutique en ligne.
Nous vous recommandons de vérifier les données reçues via " Formulaire de notification de paiement":

  1. Vérifiez si les données sont réellement transférées depuis le système IntellectMoney (vérification de la source de données) par adresse IP.
  2. Vérifier si les données ont été corrompues lors de la transmission (Data Integrity Check)
  3. Vérifier le montant du paiement
  4. Vérifiez le numéro de site de la boutique en ligne

4.3.1. Vérification de la source de données

Comme mentionné ci-dessus, la valeur du paramètre "Clé secrète" ne doit être connue que du système IntellectMoney et de la boutique Internet. Basé sur ceci, La clé secrète peut être utilisé pour authentifier la source qui a envoyé les données de paiement. Une boutique en ligne peut s'authentifier à l'aide de plusieurs méthodes, selon que la fonctionnalité est activée "Envoyer la clé privée".
Les demandes adressées au magasin à partir du système IntellectMoney ne peuvent provenir que du sous-réseau 91.212.151.0/24 . Un exemple de vérification de l'appartenance d'une IP à un sous-réseau :

Exemple

Si (!preg_match("/91.212.151.\d(0,255)/", $_SERVER["REMOTE_ADDR"]))( renvoie "ERROR! IP MISMATCH!"; die; )

Pour le transfert de données, il est souhaitable d'utiliser le protocole HTTPS.

4.3.2.1. Formation de la signature de contrôle

Lors de la génération d'une signature de contrôle, le système IntellectMoney "colle" les valeurs des champs sur une seule ligne en les séparant par "::".
Pour " Formulaires de notification de paiement
eshopId);
numéro de commande);
3. Description de l'achat ( Nom du service);
4. Numéro de compte dans le système IntellectMoney ( eshopCompte);
5. Montant du paiement ( destinataireAmount);
6. Monnaie de paiement ( devise du destinataire);
7. État du paiement ( statut de paiement);
8. Nom d'utilisateur ( nom d'utilisateur);
9. Courriel de l'utilisateur ( userEmail);
10. Date et heure du paiement ( paiementDonnées);
11. Clé secrète ( clef secrète)

Exemple 4. Formation d'une chaîne et signature pour vérification dans "Formulaire de notification de paiement"

Ligne de signature : 17354 :: order_0000001 :: Book :: 4356091274 :: 12.30 :: RUB :: 5 :: Artem Dvoryadkin :: [courriel protégé]::2010-01-17 13:12:03::maClé
Hachage reçu :
Lors de la mise en œuvre de la vérification de signature, il est recommandé de vérifier le résultat avec l'exemple ci-dessus.

Pour "", les champs suivants sont collés ensemble dans l'ordre suivant :

  1. Numéro de site Web de la boutique en ligne ( eshopId);
  2. Numéro d'achat de la boutique en ligne ( numéro de commande);
  3. Action demandée ( action);
  4. La clé secrète ( clef secrète)

Exemple 5. Formation d'une chaîne et signature pour "Formulaires de demande de crédit ou de déblocage de fonds"

Chaîne de signature : 17354::order_0000001::ToPaid::myKey
Hachage reçu :
Lors de la mise en œuvre de la génération de signature, il est recommandé de vérifier le résultat obtenu avec l'exemple ci-dessus.
MD5 est formé d'une séquence de 32 chiffres hexadécimaux (exemple "f849a1c57c66b372ec4a3a2e04d2feba") conformément à l'algorithme largement utilisé Message Digest 5 (MD5) développé par Ron Rivest du MIT Laboratory for Computer Science et RSA Data Security, Inc. L'algorithme a été publié en ligne en avril 1992 (RFC 1321).

4.3.2.2. Vérification de la signature de contrôle

Vérification de la signature de contrôle sur le site internet de la boutique en ligne selon l'algorithme suivant :

  1. Formez une chaîne en "collant" les valeurs de paramètre obtenues via " Formulaire de notification de paiement", dans le même ordre que lors de la génération d'une signature de contrôle, en les séparant par " :: " dans le système IntellectMoney (voir ci-dessus). N'oubliez pas que lors de la génération d'une signature, La clé secrète.
  2. Calculez le MD5 de la chaîne reçue.
  3. Comparez la valeur reçue avec la valeur du paramètre " hacher"reçu par" Formulaire de notification de paiement". Si la signature générée correspond à celle reçue via " Formulaire de notification de paiement", les données ne sont pas modifiées, et la source de données est bien le système IntellectMoney.

4.3.2.3. Vérification du montant et de la devise du paiement

Malgré le fait que l'utilisateur (acheteur) ne peut pas modifier le montant du paiement, il est recommandé que la boutique en ligne contrôle les informations sur le montant et la devise du paiement transmises via le " destinataireAmount" Et " devise du destinataire".

4.3.2.4 Vérification du numéro de site (ID) de la boutique en ligne

Malgré le fait que l'utilisateur (acheteur) ne peut pas modifier le numéro du site sur lequel le paiement est effectué, il est recommandé à la boutique en ligne de contrôler les informations sur le numéro de site, qui sont transmises via le " eshopId", en particulier lorsque vous utilisez plusieurs sites pour accepter des paiements via le système IntellectMoney.

4.4.1 Validation des données du formulaire de demande


1. Numéro de site Web de la boutique en ligne ( eshopId);
2. Numéro d'achat de la boutique en ligne ( numéro de commande);
3. Description de l'achat ( Nom du service);
4. Montant du paiement ( destinataireMontant);
5. Monnaie de paiement ( devise du destinataire);
6. Clé secrète ( clef secrète);

Exemple

  1. eshopId= 17354
  2. numéro de commande=1
  3. Nom du service=acheter un livre je veux tout savoir
  4. destinataire Montant=10,10
  5. devise du destinataire=RUB
  6. clef secrète=tester


Chaîne de signature : "17354::1::achat de livre, je veux tout savoir ::10,10::RUB::test".

Exemple de signature

L'exactitude de la formation de la signature peut être vérifiée dans le calculateur de signature de hachage

4.4.2 Validation des données du formulaire de demande pour les opérations planifiées

Pour exclure le cas d'usurpation des données transmises par le magasin, le magasin peut les signer. Dans ce cas, le GI vérifiera les données reçues en fonction de la signature. En cas de divergence entre les données transférées et la signature, l'achat ne sera pas créé. Pour activer le mode, dans les paramètres du protocole IntellectMoney, cochez la case à côté du champ "Require Hash" et enregistrez les paramètres du protocole. La signature est formée en "collant" les valeurs de champ sur une seule ligne à l'aide du séparateur "::".
1. Numéro de site Web de la boutique en ligne ( eshopId);
2. Numéro d'achat de la boutique en ligne ( numéro de commande);
3. Description de l'achat ( Nom du service);
4. Montant du paiement ( destinataireMontant);
5. Monnaie de paiement ( devise du destinataire);
6. Clé secrète ( clef secrète);

Exemple

  1. eshopId= 17354
  2. numéro de commande=1
  3. Nom du service=acheter un livre je veux tout savoir
  4. destinataire Montant=10,10
  5. devise du destinataire=RUB
  6. récurrentType=Activer
  7. clef secrète=tester


Ligne de signature : "17354::1::achat de livre Je veux tout savoir ::10,10::RUB::Activate::test".

Exemple de signature

4.5 Règles de génération d'un reçu pour une caisse enregistreuse en ligne (merchantReceipt)

Données pour générer un chèque dans la caisse en ligne. Représente une chaîne JSON. Pour que le nom du produit s'affiche correctement dans le ticket de caisse, le paramètre text doit être passé en codage UTF-8. Vous pouvez générer correctement une chaîne JSON à partir du tableau de données à l'aide de la fonction du langage de programmation PHP json_encode. Vous pouvez vérifier l'exactitude de la chaîne JSON à l'aide de la fonction json_decode du langage de programmation PHP.

Important: Les documents sont générés par le fiscal drive (FN), ce fait impose l'encodage des chaînes transmises, les messages sont échangés via http avec la caisse enregistreuse en encodage UTF-8, mais lors de l'écriture vers le FN, les lignes sont transmises en Encodage CP866, qui prend en charge un jeu de caractères plus petit que UTF-8 , par exemple : dans CP866, il n'y a pas de caractères "" et ils ne seront pas transférés vers FN - au lieu de la chaîne " Jus "Poire"" dans le document sera " Jus de poire. L'échappement des caractères est possible avec une barre oblique inverse "\" ou avec la fonction addlashes de PHP.

Structure JSON - Chaînes

( "auberge":"7704019762", "groupe":"Principal", "contenu": ( "type":1, "clientContact":" [courriel protégé]" "positions":[ ( "quantity":2.000, "price":12.45, "tax":6, "text":"Bulka" ), ( "quantity":1.000, "price":5.10, "tax" :4, "text":"Correspond" ) ], ) )

Nom

Élément

Description

Validation du montantsauterMontantVérifier

Désactivez la vérification intégrée que les sommes des éléments de chèque correspondent au montant de la facture. Par défaut, si le paramètre n'est pas passé - 0

Peut prendre les valeurs 0 ou 1

Votre numéro TIN.aubergeNuméro de contribuable individuel obtenu auprès du Service fédéral des impôts
Nom de groupe. groupe

La valeur par défaut est "Principal". Pour ajouter un autre groupe, vous devez créer un nouveau groupe dans Orange Data.

Si vous passez un groupe qui n'existe pas, Orange Data retournera une erreur.

Contenu des documents contenuVoir le contenu de ce champ dans le contenu du tableau.

tableau de contenu

Nom

Élément

Description

Type de documenttaper

Vous devez passer un nombre, selon l'action :

  1. À venir
  2. retour paroisse
  3. Consommation
  4. Rapport de dépenses
Données de l'acheteur contact client

Téléphone ou e-mail - acheteur

Format du téléphone : +ХХХХХХХХХХ

Signe d'agentagentType

Champ facultatif. Il est transmis si le rapport d'inscription et (ou) le rapport de réinscription en cours contient l'attribut « attribut agent » (tag 1057) qui a une valeur identique à la valeur de l'attribut « attribut agent » (tag 1057) de la caisse reçu.

Pour les types d'agents, les valeurs suivantes doivent être passées :

  1. agent payeur bancaire - agentType = 1
  2. sous-agent de paiement bancaire - agentType = 2
  3. agent payeur - agentType = 4
  4. sous-agent de paiement - agentType = 8
  5. agent - typeagent = 16
  6. agent - typeagent = 32
  7. autre agent - agentType = 64

Si le vendeur a plusieurs attributs d'agent, par exemple, un sous-agent de paiement bancaire (agentType = 2), un agent vérifié (agentType = 16) et un autre agent (agentType = 64), alors la valeur du paramètre agentType doit être la somme des valeurs agentType de chacun des attributs agent, c'est-à-dire pour les types répertoriés dans cet exemple, le paramètre agentType = 2 + 16 + 64 = 82

Peut prendre une valeur de 1 à 127

Liste des positions dans le chèque postes

Liste des marchandises pour lesquelles le paiement est effectué. Le nombre maximum de marchandises est de 170 unités. Voir le contenu de ce champ dans le tableau des positions.

tableau des positions

Nom

Obligatoire

Description

quantitéOui

Quantité de marchandises.

Nombre décimal précis à 3 caractères après le point.

prixOui

Le prix du produit, y compris toutes les remises et majorations.

Nombre décimal jusqu'à deux décimales.

impôtOui

Taux de TVA. Vous devez passer un nombre de 1 à 6 :

1 - Taux de TVA 20%

2 - Taux de TVA 10%

3 - Taux de TVA 20/120

4 - Taux de TVA calculé. 10/110

5 - Taux de TVA 0%

6 - Exonéré de TVA

texteOui

Description de la position dans le chèque (marchandises).

Chaîne jusqu'à 128 octets.

paiementSubjectType

Non

L'objet du calcul. Vous devez passer un nombre de 1 à 13 :

Produit = 1,
Produits soumis à accise = 2,
Travail = 3,
Service = 4,
Pari de jeu = 5,
Gain de jeu = 6,
Billet de loterie = 7,
Gain à la loterie = 8,
Fourniture de RIA = 9,
Paiement = 10,
Commission d'agence = 11,
Sujet composite de calcul = 12,
Autre sujet de calcul = 13

paymentMethodTypeNon

Méthode de calcul. Vous devez passer un nombre de 1 à 7 (Si null est passé,
alors la valeur 4 - Règlement intégral sera transférée au sujet du calcul.):

Acompte 100% = 1,
Prépaiement partiel = 2,
Avance = 3,
Calcul complet = 4,
Règlement partiel et crédit = 5,
Virement à crédit = 6,
Paiement du prêt = 7

Exemple de code à insérer dans un formulaire

Un exemple de formation de vendorReceipt en PHP

$inputPositions = array(array("quantity"=>"1", "price"=>"10", "tax"=>"6", "text"=>"Item number 1"), array("quantity" "=>"1", "price"=>"11", "tax"=>"6", "text"=>"Article numéro 2"), array("quantity"=>"1", "price "=>"12", "tax"=>"6", "text"=>"Article numéro 3")); function createMerchantReceipt($inputPositions)( $inn = "Votre IIN"; $customerContact = " [courriel protégé]";//Courrier du payeur $positions = array(); foreach($inputPositions as $position)( $positions = array("quantity" => $position["quantity"], "price" => $position["price "], "tax" => $position["tax"], "text" => $position["text"],); ) $merchantReceipt = array("inn" => $inn, "group" => "Main", "content" => array("type" => "1", "positions" => $positions, "customerContact" => $customerContact)); return json_encode($merchantReceipt); )

Options supplémentaires. Des paramètres supplémentaires sont nécessaires pour transmettre des informations ou des données supplémentaires à l'URL de résultat et à la page de votre compte.
Important: lors de la transmission d'un paramètre supplémentaire autre que userField_N et userFieldName_N, ces paramètres ne seront transmis nulle part.
Vous trouverez ci-dessous un exemple de formulaire qui soumet cinq valeurs : " UserField_1", "UserField_2", "UserFieldName_2", "UserFieldName_3", "AnotherField" :

Un exemple de formulaire de demande de paiement avec des paramètres supplémentaires Développer la source

frotter.

En savoir plus sur les valeurs :

Nom de la valeur

Signification

URL de résultat

Espace personnel

UserField_1valeur_1Nom : "Champ utilisateur_1"
Valeur : "value_1"

Nom : "Champ utilisateur_1"
Valeur : "value_1"

UserField_2valeur_2Nom: " UserField_2"
Signification: " valeur_2"

Nom : "Nom du paramètre pour la valeur_2"

Valeur : "value_2"

UserFieldName_2
Nom du paramètre pour value_2Nom : "NomChampUtilisateur_2"
Signification: "


Avoir des questions?

Signaler une faute de frappe

Texte à envoyer à nos rédacteurs :