API Fonctionnement Tester Acheter Contact
 
virement sepa prelevement

Bienvenue dans l'API Sepa

Le SEPA « Single Euro Payments Area », l'Espace unique de paiement en euro, est effectif depuis le 1er février août 2014. Il s'agit d'une nouvelle gamme unique de moyen de paiement en euros, commune à tous les pays européens.

A partir de cette date, les virement et prélèvements effectués par les associations, entreprises, TPE, PME, comités d'entreprises, syndicats, clubs, devront obligatoirement respecter les nouvelles normes qui y sont liées.

Les principaux éditeurs de logiciels comptables ont certainement mis à jour leurs solutions afin d'être prêts à cette échéance. Dans le cas contraire, vous devrez vous même convertir vos fichiers de l'ancien format CFONB (Comité Français d'Organisation et de Normalisation Bancaires) vers le nouveau format SEPA.

L'API SepaWin vous propose de le faire pour vous, simplement.



Liens utiles :
Logiciel SepaWin
Convertisseur en ligne RIB » IBAN et BIC
Comité national SEPA
Comité Français d'Organisation et de Normalisation Bancaires

Plateformes disponibles :
Web

Mots clés :
Le virement SEPA est aussi appelé SCT pour « SEPA Credit Transfer ».
Le prélèvement SEPA est aussi appelé SDD pour « SEPA Direct Debit ».

L'API SepaWin est particulièrement bien adaptée pour les solutions web externes étant donné sa souplesse de fonctionnement et son faible prix.

suite   »   fonctionnement
 

Fonctionnement

L'API SepaWin vous permet de générer des buffers de données ou des fichiers au format XML à partir de 3 requêtes web simples:
  • Création d'une transaction de virement ou de prélèvement
  • Ajout de lignes dans la transaction
  • Génération du résultat sous forme d'un fichier ou d'un buffer de données

  • Préalable

    Avoir créé une licence API SepaWin avec les éléments suivants:
  • Votre IBAN (qui constitue la clé de licence SepaWin)
  • Votre BIC
  • Votre RAISON SOCIALE
  • Votre NUMERO DE SIRET
  • Votre ICS (Identifiant de créancier SEPA : uniquement si vous souhaitez effectuer des prélèvements)

  • Création d'une transaction

    Appeler l'url « https://www.sepawin.com/api/ » avec les arguments GET suivants:
  • a : « start »
  • i : Votre IBAN (qui constitue la clé de licence SepaWin)
  • t : Type de transaction : « virement » ou « prelevement »
  • r : Référence de la transaction : 30 caractères alphanumériques maximum, pas d'accents ni de caractères spéciaux
  • d : Date d'exécution au format 06/12/2024

  • Le retour est au format JSON et se compose de deux données:
  • status : « ok » ou erreur spécifiée
  • transaction : identifiant unique de transaction (uniquement disponible si le status est « ok »)

  • Exemple de création de transaction en PHP:
    $iban = "Votre clé de licence";
    $return = file_get_contents( "https://www.sepawin.com/api/?a=start&i=".$iban."&t=virement&r=ma+reference&d=06/12/2024" );
    $return = json_decode($return);
    if( is_object($return) && $return->statut=="ok" )
    {
          // Ok
          print_r( $return );
    }

    Affiche :
    stdClass Object
    (
          [statut] => ok
          [transaction] => 82
    )

    Ajout de lignes dans la transaction

    Appeler l'url « https://www.sepawin.com/api/ » avec les arguments GET suivants:
  • a : « add »
  • i : Votre IBAN (qui constitue la clé de licence SepaWin)
  • t : Identifiant de transaction : Valeur retournée par l'appel API « start »
  • m : Montant de la ligne au format 00.00 ou 00,00
  • d : IBAN destinataire
  • b : BIC destinataire
  • n : Nom du destinataire : 30 caractères alphanumériques maximum, pas d'accents ni de caractères spéciaux
  • l : Libellé de la transaction : 30 caractères alphanumériques maximum, pas d'accents ni de caractères spéciaux
  • r : RUM : (uniquement obligatoire pour les prélèvements)
  • s : Date de signature du mandat : au format 06/12/2024 (uniquement obligatoire pour les prélèvements)
  • f : Traiter cette ligne en FRST (*) ou en RCUR ? « 1 » pour FRST. Toute autre valeur pour RCUR. (uniquement obligatoire pour les prélèvements)
  • e : Date d'échéance : au format 06/12/2024. Remplace la date d'exécution d'entête si renseignée. (optionnel, et uniquement pour les prélèvements)

  • 18/09/2020 : ajout du code pays et de l'adresse postale du bénéficiaire du virement
  • c : Code pays au format ISO 3166 à 2 caractères (code alpha-2) : (optionnel, et uniquement pour les virements) liste des codes pays
  • p : Adresse postale du bénéficiare (optionnel, et uniquement pour les virements)

  • 26/10/2022 : ajout du code postal et de la ville du bénéficiaire du virement
  • q : Code postal du bénéficiare (optionnel, et uniquement pour les virements)
  • v : Ville du bénéficiare (optionnel, et uniquement pour les virements)

  • Le code pays, l'adresse postale, le code postal et la ville permettent de transférer les coordonnées d'un bénéficiare d'un virement et sont nécessaires pour les destinataires en dehors de la zone EEE (Suisse, Andorre, ...). Les quatre informations doivent être renseignées pour être ajoutées au fichier SEPA.


    (*): Depuis le 20 novembre 2016, la norme SEPA (Single European Payments Area) à évoluée et les séquences FIRST sont devenues optionnelles.


    Le retour est au format JSON et se compose de cinq données:
  • status : « ok » ou erreur spécifiée
  • lignes_ajoutees : Nombre de lignes ajoutées par cette action (uniquement disponible si le status est « ok ») Donnée disponible à des fins de contrôle.
  • montant_ajoute : Montant ajouté par cette action (uniquement disponible si le status est « ok ») Donnée disponible à des fins de contrôle.
  • lignes_total : Nombre de lignes ajoutées au total (uniquement disponible si le status est « ok »). Donnée disponible à des fins de contrôle.
  • montant_total : Montant ajouté au total (uniquement disponible si le status est « ok ») Donnée disponible à des fins de contrôle.

  • Exemple d'ajout de ligne en PHP:
    $iban = "Votre clé de licence";
    $transaction = "identifiant de transaction retourné par l'appel à l'API start";
    $return = file_get_contents( "https://www.sepawin.com/api/?a=add&i=".$iban."&t=".$transaction."&m=123,45&d=FR0000000000000000000000000&b=CMCIFR2A&n=nom&l=libelle" );
    $return = json_decode($return);
    if( is_object($return) && $return->statut=="ok" )
    {
          // Ok
          print_r( $return );
    }

    Affiche :
    stdClass Object
    (
          [statut] => ok
          [lignes_ajoutees] => 1
          [montant_ajoute] => 123.45
          [lignes_total] => 1
          [montant_total] => 123.45
    )

    Génération du résultat

    Appeler l'url « https://www.sepawin.com/api/ » avec les arguments GET suivants:
  • a : « create »
  • i : Votre IBAN (qui constitue la clé de licence SepaWin)
  • t : Identifiant de transaction : Valeur retournée par l'appel API « start »
  • o : Format de sortie : « buffer » ou « file »
  • li : (option) Forçage du type de prélèvement (balise LclInstrm). Valeur par défaut CORE

  • Le retour est au format JSON et se compose de deux données:
  • status : « ok » ou erreur spécifiée
  • buffer : Contenu XML au format SEPA
  • ou
  • file : Url d'accès au fichier SEPA généré

  • Exemple de génération de fichier en PHP:
    $iban = "Votre clé de licence";
    $transaction = "identifiant de transaction retourné par l'appel à l'API start";
    $return = file_get_contents( "https://www.sepawin.com/api/?a=create&i=".$iban."&t=".$transaction."&o=file" );
    $return = json_decode($return);
    if( is_object($return) && $return->statut=="ok" )
    {
          // Ok
          print_r( $return );
    }

    Affiche :
    stdClass Object
    (
          [statut] => ok
          [file] => https://www.sepawin...xml
    )




    Exemple complet en PHP:
    $iban = "Votre clé de licence";
    $return = file_get_contents( "https://www.sepawin.com/api/?a=start&i=".$iban."&t=virement&r=ma+reference&d=06/12/2024" );
    $return = json_decode($return);
    if( is_object($return) && $return->statut=="ok" )
    {
    $transaction = $return->transaction;

    $return = file_get_contents( "https://www.sepawin.com/api/?a=add&i=".$iban."&t=".$transaction."&m=123&d=FR0000000000000000000000000&b=CMCIFR2A&n=nom&l=libelle" );

    $return = file_get_contents( "https://www.sepawin.com/api/?a=add&i=".$iban."&t=".$transaction."&m=456&d=FR0000000000000000000000000&b=CMCIFR2A&n=nom&l=libelle" );

    $return = file_get_contents( "https://www.sepawin.com/api/?a=add&i=".$iban."&t=".$transaction."&m=789&d=FR0000000000000000000000000&b=CMCIFR2A&n=nom&l=libelle" );

    $return = file_get_contents( "https://www.sepawin.com/api/?a=create&i=".$iban."&t=".$transaction."&o=file" );

    $return = json_decode($return);

    if( is_object($return) && $return->statut=="ok" )
    {
    // Ok
    print_r( $return );
    }
    }

    Affiche :
    stdClass Object
    (
    [statut] => ok
    [file] => https://www.sepawin...xml
    )



    suite   »   tester




























































     

    Tester l'API

    Vous pouvez tester gratuitement l'API Sepa. Pour tester LE LOGICIEL SEPAWIN (sous Windows) et non pas l'API SepaWin, c'est par ici

    Merci de renseigner les éléments suivants :

    IBAN:
    Votre IBAN est la clé de licence de l'API SepaWin. Votre IBAN est nécessaire pour la création des fichiers SEPA
    BIC:
    Votre BIC est nécessaire pour la création des fichiers SEPA
    Raison sociale:
    Votre raison sociale est nécessaire pour la création des fichiers SEPA. 30 caractères max, ni accents ni caractères spéciaux.
    Numéro de SIRET:
    Votre numéro de SIRET est nécessaire pour la création des fichiers SEPA
    Numéro ICS:
    Identifiant Créancier Sepa. Votre numéro ICS est nécessaire pour la création des fichiers SEPA uniquement si vous souhaitez effectuer des prélèvements.
    Adresse email:
     

     
     
     

    Acheter

    La licence d'utilisation est disponible pour 100,00 € HT / an pour le premier IBAN, et 25 € HT / an / IBAN supplémentaire.
    Cette API possède un fonctionnement standard, d'où son faible coût de licence. Si vos besoins sont plus larges que ses caractéristiques, notre société vous proposera un développement spécifique autour de cette licence.

    Conditions générales de vente

    Pour acquérir la licence d'utilisation, nous vous proposons un règlement par virement ou chèque bancaire.

    Le paiement par chèque bancaire

    Pour régler par chèque, merci de nous envoyer un chèque de 120,00 € TTC (TVA à 20,00 %) à l'adresse ci-dessous.

      SAS HEYHOP
    9 rue de Montigny
    14810 Gonneville en Auge
      Merci d'acccompagner votre chèque de :
  • Adresse email (pour recevoir le logiciel ainsi que la facture au format PDF à imprimer)
  • Adresse de facturation
  • IBAN (jusqu'à 3)
  • BIC
  • RAISON SOCIALE
  • NUMERO DE SIRET
  • NUMERO ICS si vous souhaitez prélever
  •  



    Le paiement par virement bancaire

    Pour régler par virement, merci de renseigner le formulaire ci-dessous. Nous vous enverrons par retour de mail nos coordonnées bancaires pour pouvoir effectuer le virement de 120,00 € TTC.
    Une fois ce virement confirmé, vous recevrez la version complète par email, accompagnée de la facture au format PDF à imprimer.

    Société: 
    Adresse de facturation: 
    Code postal / localité: 
    IBAN (jusqu'à 3): 
    BIC: 
    SIRET: 
    ICS: 
    Adresse email:  
     
     
     

    Contact

      SAS HEYHOP

    9 rue de Montigny

    14810 Gonneville en Auge



    RCS : CAEN 754 082 691 00033
     
    Société: 
    Téléphone: 
    Adresse email: 
    Message:  
     
     
       

    Votre fichier est rejeté par la banque ?


    Avant de nous appeler, vérifiez les principaux cas de rejet rencontrés par les utilisateurs de SepaWin:
  • Utilisation du caractère & (et commercial) dans un des libellés ou tout autres caractères speciaux
  • Utilisation d'accents dans un des libellés
  • Mauvaise gestion des dates : la date de prélèvement doit être au minimum 6 jours après la date de signature de mandat dans le cas d'un prélèvement FIRST et 3 jours dans le cas d'un prélèvement RCUR