HelloAsso vous permet de recevoir une notification (ou webhook) sur votre site internet lorsqu'une action est effectuée sur votre compte HelloAsso.

Recevoir des notifications

📘
Tester les notifications
Afin de tester en live les notifications, nous vous invitons à utiliser un site comme: https://webhook.site/ qui permet de générer des URL de notification temporaire et de voir les appels qui y sont fait.

Vous êtes une association

Rendez-vous dans votre compte HelloAsso, section Mon Compte > Intégrations et API afin d'inscrire votre URL de notification.

Vous êtes un partenaire

Vous pouvez définir une url de notification générale en utilisant cette URL, vous recevrez toutes les notifications de toutes les associations qui sont liées à vous par la mire d’autorisation.
Vous pouvez définir une url de notification spécifique pour une association en utilisant cette URL, vous ne recevrez alors que les notifications concernant cette association.

Sur ces deux points d'API il est également possible de spécifier le type de notification que vous souhaitez recevoir en spécifiant le paramètre notificationType lors de la définition de votre url de notification. (Order, Payment, Form, Organization). Si ce paramètre est laissé null alors l'URL concernera tous les types de notifications.

Vous pourrez donc avoir jusqu’à 5 Urls de notification par association ou jusqu’à 5 Urls de notification globales (qui concernent toutes les associations)

Exemple : Url de notification globale

Si vous effectuez l'appel API suivant :

curl --request PUT \
     --url https://api.helloasso.com/v5/partners/me/api-notifications \
     --header 'authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyYmQzYzJjODM3ZGM0N2FiOTY3ZDQ3NWZlMzlmN2E1ZCIsImNwcyI6WyJBY2Nlc3NQdWJsaWNEYXRhIiwiQWNjZXNzVHJhbnNhY3Rpb25zIiwiQ2hlY2tvdXQiLCJGb3JtT3BlbkRpcmVjdG9yeSIsIkdyYW50QXV0aG9yaXphdGlvbkNvZGUiLCJPcmdhbml6YXRpb25PcGVuRGlyZWN0b3J5IiwiUmVmdW5kTWFuYWdlbWVudCJdLCJwYXIiOiJIZWxsb0Fzc29UZXN0IiwibmJmIjoxNzE3NDA4MTk3LCJleHAiOjE3MTc0MDk5OTcsImlzcyI6Imh0dHBzOi8vYXBpLmhlbGxvYXNzby1zYW5kYm94LmNvbSIsImF1ZCI6ImJmYjViYWI4ZjBkYTQ1ZWJhZjg2OTY3MjY2MGFmY2JkIn0.I52VRcpHiG8KoLLM90Xb6WV6FqW9hKZchdYtyFKjnLrqRDq5yqk4iOrLdQwoFiuwZfpJxhcQVlfPyZtlPpaKVcsYPOTmA6kEAoLLjOR-Zv948hW2GEZquuYDGD61ybvcozO0YW6KsVDj7ptpml0prvYW-S211KFMHSsa2PCn8j6ikLx1iQMPxOsDNhwcX5gVScHp7l7F0L9csKpjd1aNwqAah09x9T1RdhsEXiGo7S0DnpYEtHb-kBUMXkdWbi4BMT-1dXusy5GVhnAG_TzVgjMcpB3BqBEMELVlCOmFEAWjtKxdYSAyNLv3W-9lComu42vYkqCkXSUdHW5N94GP3Q' \
     --header 'content-type: application/*+json' \
     --data '
{
  "url": "https://www.notification.com"
}
'

La "NotificationType" n'étant pas spécifié l'URL de notification défini concernera toutes les notifications.

Si vous faites ensuite cet appel API :

curl --request PUT \
     --url https://api.helloasso.com/v5/partners/me/api-notifications \
     --header 'authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyYmQzYzJjODM3ZGM0N2FiOTY3ZDQ3NWZlMzlmN2E1ZCIsImNwcyI6WyJBY2Nlc3NQdWJsaWNEYXRhIiwiQWNjZXNzVHJhbnNhY3Rpb25zIiwiQ2hlY2tvdXQiLCJGb3JtT3BlbkRpcmVjdG9yeSIsIkdyYW50QXV0aG9yaXphdGlvbkNvZGUiLCJPcmdhbml6YXRpb25PcGVuRGlyZWN0b3J5IiwiUmVmdW5kTWFuYWdlbWVudCJdLCJwYXIiOiJIZWxsb0Fzc29UZXN0IiwibmJmIjoxNzE3NDA4MTk3LCJleHAiOjE3MTc0MDk5OTcsImlzcyI6Imh0dHBzOi8vYXBpLmhlbGxvYXNzby1zYW5kYm94LmNvbSIsImF1ZCI6ImJmYjViYWI4ZjBkYTQ1ZWJhZjg2OTY3MjY2MGFmY2JkIn0.I52VRcpHiG8KoLLM90Xb6WV6FqW9hKZchdYtyFKjnLrqRDq5yqk4iOrLdQwoFiuwZfpJxhcQVlfPyZtlPpaKVcsYPOTmA6kEAoLLjOR-Zv948hW2GEZquuYDGD61ybvcozO0YW6KsVDj7ptpml0prvYW-S211KFMHSsa2PCn8j6ikLx1iQMPxOsDNhwcX5gVScHp7l7F0L9csKpjd1aNwqAah09x9T1RdhsEXiGo7S0DnpYEtHb-kBUMXkdWbi4BMT-1dXusy5GVhnAG_TzVgjMcpB3BqBEMELVlCOmFEAWjtKxdYSAyNLv3W-9lComu42vYkqCkXSUdHW5N94GP3Q' \
     --header 'content-type: application/*+json' \
     --data '
{
  "url": "https://www.notification.com",
  "notificationType": "Order"
}
'

Vous allez définir une URL de notification supplémentaire ou ne seront envoyés que les notifications de type "Order".

Exemple : Url de notification dédié à une association

Si vous effectuez l'appel API suivant :

curl --request PUT \
     --url https://api.helloasso.com/v5/partners/me/api-notifications/organizations/club-foot-bordeaux \
     --header 'authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyYmQzYzJjODM3ZGM0N2FiOTY3ZDQ3NWZlMzlmN2E1ZCIsImNwcyI6WyJBY2Nlc3NQdWJsaWNEYXRhIiwiQWNjZXNzVHJhbnNhY3Rpb25zIiwiQ2hlY2tvdXQiLCJGb3JtT3BlbkRpcmVjdG9yeSIsIkdyYW50QXV0aG9yaXphdGlvbkNvZGUiLCJPcmdhbml6YXRpb25PcGVuRGlyZWN0b3J5IiwiUmVmdW5kTWFuYWdlbWVudCJdLCJwYXIiOiJIZWxsb0Fzc29UZXN0IiwibmJmIjoxNzE3NDA4MTk3LCJleHAiOjE3MTc0MDk5OTcsImlzcyI6Imh0dHBzOi8vYXBpLmhlbGxvYXNzby1zYW5kYm94LmNvbSIsImF1ZCI6ImJmYjViYWI4ZjBkYTQ1ZWJhZjg2OTY3MjY2MGFmY2JkIn0.I52VRcpHiG8KoLLM90Xb6WV6FqW9hKZchdYtyFKjnLrqRDq5yqk4iOrLdQwoFiuwZfpJxhcQVlfPyZtlPpaKVcsYPOTmA6kEAoLLjOR-Zv948hW2GEZquuYDGD61ybvcozO0YW6KsVDj7ptpml0prvYW-S211KFMHSsa2PCn8j6ikLx1iQMPxOsDNhwcX5gVScHp7l7F0L9csKpjd1aNwqAah09x9T1RdhsEXiGo7S0DnpYEtHb-kBUMXkdWbi4BMT-1dXusy5GVhnAG_TzVgjMcpB3BqBEMELVlCOmFEAWjtKxdYSAyNLv3W-9lComu42vYkqCkXSUdHW5N94GP3Q' \
     --header 'content-type: application/*+json' \
     --data '
{
  "url": "https://www.notification.com"
}
'

La "NotificationType" n'étant pas spécifié l'URL de notification défini concernera toutes les notifications et seulement l'association "club-foot-bordeaux"

Si vous faites ensuite cet appel API :

curl --request PUT \
     --url https://api.helloasso.com/v5/partners/me/api-notifications/organizations/club-foot-bordeaux \
     --header 'authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiIyYmQzYzJjODM3ZGM0N2FiOTY3ZDQ3NWZlMzlmN2E1ZCIsImNwcyI6WyJBY2Nlc3NQdWJsaWNEYXRhIiwiQWNjZXNzVHJhbnNhY3Rpb25zIiwiQ2hlY2tvdXQiLCJGb3JtT3BlbkRpcmVjdG9yeSIsIkdyYW50QXV0aG9yaXphdGlvbkNvZGUiLCJPcmdhbml6YXRpb25PcGVuRGlyZWN0b3J5IiwiUmVmdW5kTWFuYWdlbWVudCJdLCJwYXIiOiJIZWxsb0Fzc29UZXN0IiwibmJmIjoxNzE3NDA4MTk3LCJleHAiOjE3MTc0MDk5OTcsImlzcyI6Imh0dHBzOi8vYXBpLmhlbGxvYXNzby1zYW5kYm94LmNvbSIsImF1ZCI6ImJmYjViYWI4ZjBkYTQ1ZWJhZjg2OTY3MjY2MGFmY2JkIn0.I52VRcpHiG8KoLLM90Xb6WV6FqW9hKZchdYtyFKjnLrqRDq5yqk4iOrLdQwoFiuwZfpJxhcQVlfPyZtlPpaKVcsYPOTmA6kEAoLLjOR-Zv948hW2GEZquuYDGD61ybvcozO0YW6KsVDj7ptpml0prvYW-S211KFMHSsa2PCn8j6ikLx1iQMPxOsDNhwcX5gVScHp7l7F0L9csKpjd1aNwqAah09x9T1RdhsEXiGo7S0DnpYEtHb-kBUMXkdWbi4BMT-1dXusy5GVhnAG_TzVgjMcpB3BqBEMELVlCOmFEAWjtKxdYSAyNLv3W-9lComu42vYkqCkXSUdHW5N94GP3Q' \
     --header 'content-type: application/*+json' \
     --data '
{
  "notificationType": "Order",
  "url": "https://www.notification.com"
}
'

Vous allez définir une URL de notification supplémentaire ou ne seront envoyés que les notifications de type "Order" et concernera seulement l'association "club-foot-bordeaux"

Type de notification

Vous recevrez une notification lorsque l'un des événements suivants se produira, utilisez le champs eventType pour connaitre le type de notification.

Évènement	eventType
Une campagne est créée (exemple)	Form
Une commande est créée (exemple)	Order
Un paiement (unique ou par échéances) est autorisé (exemple)	Payment
Un remboursement est effectué (exemple)	Payment
Un paiement est contesté par le payeur auprès de sa banque (exemple)	Payment
Un paiement par échéance est refusé	Payment
Une association change de nom, son slug est donc changé (exemple)	Organization
Un remboursement échoue	Payment

Indisponibilité de votre site

Si HelloAsso n'a pas un retour 200 lors de l'envoi de la notification, nous allons réessayer plusieurs fois de la délivrer.

L’intervalle du retry utilise la formule : min(48h, 3 * 2 ** attempt)

Le delais de ce retry commence à 3s et se termine, au bout de 16 retry, à 27h.

Vérifier l'authenticité de la notification

Afin de d'authentifier la notification, vous pouvez vous baser sur l'URL source de la notification.

IP Production	IP Test
51.138.206.200	4.233.135.234

Exemples de notifications

Paiement autorisé sur un formulaire de don

{
  "data": {
    "order": {
      "id": 20499,
      "date": "2024-06-07T14:11:15.7442115+02:00",
      "formSlug": "3",
      "formType": "Donation",
      "organizationName": "BordeauxChess",
      "organizationSlug": "bordeauxchess",
      "organizationType": "Association1901",
      "organizationIsUnderColucheLaw": false,
      "formName": "faire un don humanitaire",
      "meta": {
        "createdAt": "2024-06-07T14:10:49.3535024+02:00",
        "updatedAt": "2024-06-07T14:11:15.7462648+02:00"
      },
      "isAnonymous": false,
      "isAmountHidden": false
    },
    "payer": {
      "email": "[email protected]",
      "address": "23 rue du maréchal",
      "city": "Paris",
      "zipCode": "75000",
      "country": "FRA",
      "dateOfBirth": "1984-05-15T02:00:00+02:00",
      "firstName": "Hugo",
      "lastName": "Dubois"
    },
    "items": [
      {
        "shareAmount": 2000,
        "shareItemAmount": 2000,
        "id": 20499,
        "amount": 2000,
        "type": "Donation",
        "state": "Processed"
      }
    ],
    "cashOutState": "Transfered",
    "paymentReceiptUrl": "https://www.helloasso-sandbox.com/associations/bordeauxchess/formulaires/3/paiement-attestation/20499/13790",
    "id": 13790,
    "amount": 2000,
    "date": "2024-06-07T14:11:15.0825381+02:00",
    "paymentMeans": "Card",
    "installmentNumber": 1,
    "state": "Authorized",
    "meta": {
      "createdAt": "2024-06-07T14:10:49.3535024+02:00",
      "updatedAt": "2024-06-07T14:11:15.3255145+02:00"
    },
    "refundOperations": []
  },
  "eventType": "Payment"
}

Paiement autorisé sur un checkout

{
  "data": {
    "order": {
      "id": 22707,
      "date": "2024-07-10T11:50:49.0890389+02:00",
      "formSlug": "default",
      "formType": "Checkout",
      "organizationName": "bordeauxchess",
      "organizationSlug": "bordeauxchess",
      "organizationType": "Association1901",
      "organizationIsUnderColucheLaw": false,
      "formName": "Checkout",
      "meta": {
        "createdAt": "2024-07-10T11:50:34.0898335+02:00",
        "updatedAt": "2024-07-10T11:50:49.0890389+02:00"
      },
      "isAnonymous": false,
      "isAmountHidden": false
    },
    "payer": {
      "email": "[email protected]",
      "country": "FRA",
      "firstName": "John",
      "lastName": "Doe"
    },
    "items": [
      {
        "shareAmount": 1000,
        "shareItemAmount": 1000,
        "id": 22707,
        "amount": 6000,
        "type": "Payment",
        "state": "Processed",
        "name": "Adhésion football"
      }
    ],
    "cashOutState": "Transfered",
    "paymentReceiptUrl": "https://www.helloasso-sandbox.com/associations/bordeauxchess/checkout/paiement-attestation/22707",
    "id": 15222,
    "amount": 1000,
    "date": "2024-07-10T11:50:48.8859116+02:00",
    "paymentMeans": "Card",
    "installmentNumber": 1,
    "state": "Authorized",
    "meta": {
      "createdAt": "2024-07-10T11:50:34.0898335+02:00",
      "updatedAt": "2024-07-10T11:50:48.9171637+02:00"
    },
    "refundOperations": []
  },
  "eventType": "Payment",
  "metadata": {
    "id": 75698555
  }
}

Commande créé sur un formulaire de don

{
  "data": {
    "payer": {
      "email": "[email protected]",
      "address": "23 rue du maréchal",
      "city": "Paris",
      "zipCode": "75000",
      "country": "FRA",
      "dateOfBirth": "1984-05-15T02:00:00+02:00",
      "firstName": "Hugo",
      "lastName": "Dubois"
    },
    "items": [
      {
        "payments": [
          {
            "id": 13790,
            "shareAmount": 2000
          }
        ],
        "priceCategory": "Fixed",
        "qrCode": "MjA0OTk6NjM4NTMzNjYyNDkzNTM1MDI0",
        "tierDescription": "",
        "tierId": 127,
        "id": 20499,
        "amount": 2000,
        "type": "Donation",
        "initialAmount": 2000,
        "state": "Processed"
      }
    ],
    "payments": [
      {
        "items": [
          {
            "id": 20499,
            "shareAmount": 2000,
            "shareItemAmount": 2000
          }
        ],
        "cashOutState": "Transfered",
        "paymentReceiptUrl": "https://www.helloasso-sandbox.com/associations/bordeauxchess/formulaires/3/paiement-attestation/20499/13790",
        "id": 13790,
        "amount": 2000,
        "date": "2024-06-07T14:11:15.0825381+02:00",
        "paymentMeans": "Card",
        "installmentNumber": 1,
        "state": "Authorized",
        "meta": {
          "createdAt": "2024-06-07T14:10:49.3535024+02:00",
          "updatedAt": "2024-06-07T14:11:15.3255145+02:00"
        },
        "refundOperations": []
      }
    ],
    "amount": {
      "total": 2000,
      "vat": 0,
      "discount": 0
    },
    "id": 20499,
    "date": "2024-06-07T14:11:15.7442115+02:00",
    "formSlug": "3",
    "formType": "Donation",
    "organizationName": "BordeauxChess",
    "organizationSlug": "bordeauxchess",
    "organizationType": "Association1901Rig",
    "organizationIsUnderColucheLaw": false,
    "meta": {
      "createdAt": "2024-06-07T14:10:49.3535024+02:00",
      "updatedAt": "2024-06-07T14:11:15.7462648+02:00"
    },
    "isAnonymous": false,
    "isAmountHidden": false
  },
  "eventType": "Order"
}

Commandes créé sur un paiement checkout avec des échéances

à noter que vous y trouverez le checkoutIntentId ainsi que les metadata envoyés dans l'appel initial.

{
  "data": {
    "payer": {
      "email": "[email protected]",
      "country": "FRA",
      "firstName": "John",
      "lastName": "Doe"
    },
    "items": [
      {
        "payments": [
          {
            "id": 15222,
            "shareAmount": 1000
          },
          {
            "id": 15223,
            "shareAmount": 2000
          },
          {
            "id": 15224,
            "shareAmount": 2000
          },
          {
            "id": 15225,
            "shareAmount": 1000
          }
        ],
        "name": "Adhésion football",
        "priceCategory": "Fixed",
        "qrCode": "MjI3MDc6NjM4NTYyMDkwMzQwODk4MzM1",
        "id": 22707,
        "amount": 6000,
        "type": "Payment",
        "state": "Processed"
      }
    ],
    "payments": [
      {
        "items": [
          {
            "id": 22707,
            "shareAmount": 1000,
            "shareItemAmount": 1000
          }
        ],
        "cashOutState": "Transfered",
        "paymentReceiptUrl": "https://www.helloasso-sandbox.com/associations/bordeauxchess/checkout/paiement-attestation/22707",
        "id": 15222,
        "amount": 1000,
        "date": "2024-07-10T11:50:48.8859116+02:00",
        "paymentMeans": "Card",
        "installmentNumber": 1,
        "state": "Authorized",
        "meta": {
          "createdAt": "2024-07-10T11:50:34.0898335+02:00",
          "updatedAt": "2024-07-10T11:50:48.9171637+02:00"
        },
        "refundOperations": []
      },
      {
        "items": [
          {
            "id": 22707,
            "shareAmount": 2000,
            "shareItemAmount": 2000
          }
        ],
        "id": 15223,
        "amount": 2000,
        "date": "2024-09-25T00:00:00+02:00",
        "paymentMeans": "Card",
        "installmentNumber": 2,
        "state": "Pending",
        "meta": {
          "createdAt": "2024-07-10T11:50:34.0898335+02:00",
          "updatedAt": "2024-07-10T11:50:49.1033333+02:00"
        },
        "refundOperations": []
      },
      {
        "items": [
          {
            "id": 22707,
            "shareAmount": 2000,
            "shareItemAmount": 2000
          }
        ],
        "id": 15224,
        "amount": 2000,
        "date": "2024-10-25T00:00:00+02:00",
        "paymentMeans": "Card",
        "installmentNumber": 3,
        "state": "Pending",
        "meta": {
          "createdAt": "2024-07-10T11:50:34.0898335+02:00",
          "updatedAt": "2024-07-10T11:50:49.11+02:00"
        },
        "refundOperations": []
      },
      {
        "items": [
          {
            "id": 22707,
            "shareAmount": 1000,
            "shareItemAmount": 1000
          }
        ],
        "id": 15225,
        "amount": 1000,
        "date": "2024-11-25T00:00:00+01:00",
        "paymentMeans": "Card",
        "installmentNumber": 4,
        "state": "Pending",
        "meta": {
          "createdAt": "2024-07-10T11:50:34.0898335+02:00",
          "updatedAt": "2024-07-10T11:50:49.1133333+02:00"
        },
        "refundOperations": []
      }
    ],
    "amount": {
      "total": 6000,
      "vat": 0,
      "discount": 0
    },
    "id": 22707,
    "date": "2024-07-10T11:50:49.0890389+02:00",
    "formSlug": "default",
    "formType": "Checkout",
    "organizationName": "bordeauxchess",
    "organizationSlug": "bordeauxchess",
    "organizationType": "Association1901Rig",
    "organizationIsUnderColucheLaw": false,
    "checkoutIntentId": 24768,
    "meta": {
      "createdAt": "2024-07-10T11:50:34.0898335+02:00",
      "updatedAt": "2024-07-10T11:50:49.0890389+02:00"
    },
    "isAnonymous": false,
    "isAmountHidden": false
  },
  "eventType": "Order",
  "metadata": {
    "id": 75698555
  }
}

Formulaire de don créé

{  
  "data": {  
    "organizationName": "bordeauxchess",  
    "tiers": [  
      {  
        "id": 2777,  
        "tierType": "Donation",  
        "price": 2000,  
        "vatRate": 0,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2778,  
        "tierType": "Donation",  
        "price": 5000,  
        "vatRate": 0,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2779,  
        "tierType": "Donation",  
        "price": 10000,  
        "vatRate": 0,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2780,  
        "tierType": "Donation",  
        "price": 15000,  
        "vatRate": 0,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2781,  
        "tierType": "Donation",  
        "vatRate": 0,  
        "minAmount": 50,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2782,  
        "tierType": "MonthlyDonation",  
        "price": 1000,  
        "vatRate": 0,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2783,  
        "tierType": "MonthlyDonation",  
        "price": 2000,  
        "vatRate": 0,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2784,  
        "tierType": "MonthlyDonation",  
        "price": 3000,  
        "vatRate": 0,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2785,  
        "tierType": "MonthlyDonation",  
        "price": 4000,  
        "vatRate": 0,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      },  
      {  
        "id": 2786,  
        "tierType": "MonthlyDonation",  
        "vatRate": 0,  
        "minAmount": 50,  
        "paymentFrequency": "Single",  
        "isEligibleTaxReceipt": true  
      }  
    ],  
    "activityTypeId": 0,  
    "currency": "EUR",  
    "meta": {  
      "createdAt": "2024-06-07T14:15:03.5351455+02:00",  
      "updatedAt": "2024-06-07T14:15:03.53515+02:00"  
    },  
    "state": "Public",  
    "title": "Faire un don pour Bordeaux Chess",  
    "privateTitle": "Faire un don pour Bordeaux Chess",  
    "widgetButtonUrl": "<https://www.helloasso-sandbox.com/associations/bordeauxchess/formulaires/11/widget-bouton">,  
    "widgetFullUrl": "<https://www.helloasso-sandbox.com/associations/bordeauxchess/formulaires/11/widget">,  
    "formSlug": "11",  
    "formType": "Donation",  
    "url": "<https://www.helloasso-sandbox.com/associations/bordeauxchess/formulaires/11">,  
    "organizationSlug": "bordeauxchess"  
  },  
  "eventType": "Form"  
}

Changement de nom d'une association

{  
  "data": {  
    "old_slug_organization": "bordeauxchess",  
    "new_slug_organization": "bordeauxchessgame"  
  },  
  "eventType": "Organization"  
}

Paiement remboursé

{  
  "data": {  
    "order": {  
      "id": 20499,  
      "date": "2024-06-07T14:11:15.7442115+02:00",  
      "formSlug": "3",  
      "formType": "Donation",  
      "organizationName": "BordeauxChess",  
      "organizationSlug": "bordeauxchess",  
      "organizationType": "Association1901",  
      "organizationIsUnderColucheLaw": false,  
      "formName": "faire un don humanitaire",  
      "meta": {  
        "createdAt": "2024-06-07T14:10:49.3535024+02:00",  
        "updatedAt": "2024-06-07T14:22:02.5756258+02:00"  
      },  
      "isAnonymous": false,  
      "isAmountHidden": false  
    },  
    "payer": {  
      "email": "[[email protected]](mailto:[email protected])",  
      "address": "23 rue du maréchal",  
      "city": "Paris",  
      "zipCode": "75000",  
      "country": "FRA",  
      "dateOfBirth": "1984-05-15T02:00:00+02:00",  
      "firstName": "Hugo",  
      "lastName": "Dubois"  
    },  
    "items": [  
      {  
        "shareAmount": 2000,  
        "shareItemAmount": 2000,  
        "id": 20499,  
        "amount": 2000,  
        "type": "Donation",  
        "state": "Canceled"  
      }  
    ],  
    "cashOutState": "Transfered",  
    "id": 13790,  
    "amount": 2000,  
    "date": "2024-06-07T14:11:15.0825381+02:00",  
    "paymentMeans": "Card",  
    "installmentNumber": 1,  
    "state": "Refunded",  
    "meta": {  
      "createdAt": "2024-06-07T14:10:49.3535024+02:00",  
      "updatedAt": "2024-06-07T14:22:02.5166667+02:00"  
    },  
    "refundOperations": [  
      {  
        "id": 419,  
        "amount": 2000,  
        "amountTip": 390,  
        "status": "PROCESSED",  
        "meta": {  
          "createdAt": "2024-06-07T14:21:59.3510417+02:00",  
          "updatedAt": "2024-06-07T14:22:02.4705607+02:00"  
        }  
      }  
    ]  
  },  
  "eventType": "Payment"  
}

Paiement contesté

{
  "data": {
    "order": {
      "id": 8750410,
      "date": "2024-06-05T12:07:15.6812716+02:00",
      "formSlug": "default",
      "formType": "Checkout",
      "organizationName": "BordeauxChess",
      "organizationSlug": "bordeauxchess",
      "organizationType": "Association1901Rig",
      "organizationIsUnderColucheLaw": false,
      "formName": "Checkout",
      "meta": {
        "createdAt": "2024-06-05T12:07:02.5394824+02:00",
        "updatedAt": "2024-06-05T12:07:15.9531525+02:00"
      },
      "isAnonymous": false,
      "isAmountHidden": false
    },
    "payer": {
      "email": "[email protected]",
      "country": "FRA",
      "firstName": "John",
      "lastName": "Doe"
    },
    "items": [
      {
        "shareAmount": 2500,
        "shareItemAmount": 2500,
        "id": 8750410,
        "amount": 10000,
        "type": "Payment",
        "state": "Processed",
        "name": "Tshirt à mon effigie"
      }
    ],
    "cashOutState": "MoneyIn",
    "id": 14118377,
    "amount": 2500,
    "date": "2024-06-05T12:07:15.6812716+02:00",
    "paymentMeans": "Card",
    "installmentNumber": 1,
    "state": "Contested",
    "meta": {
      "createdAt": "2024-06-05T12:07:02.5394824+02:00",
      "updatedAt": "2024-06-06T15:56:11.6933333+02:00"
    },
    "refundOperations": []
  },
  "eventType": "Payment",
  "metadata": {
    "id": 5678,
    "reference": "45RGB3"
  }
}

Remboursement échoué

{
  "data": {
    "order": {
      "id": 24037,
      "date": "2024-07-31T15:40:35.3772861+02:00",
      "formSlug": "adhesion-2025",
      "formType": "Membership",
      "organizationName": "lasercutaddict2",
      "organizationSlug": "lasercutaddict2",
      "organizationType": "Association1901",
      "organizationIsUnderColucheLaw": false,
      "formName": "Adhésion 2025",
      "meta": {
        "createdAt": "2024-07-31T15:40:14.4785997+02:00",
        "updatedAt": "2024-07-31T15:43:30.3808516+02:00"
      },
      "isAnonymous": false,
      "isAmountHidden": false
    },
    "payer": {
      "email": "[email protected]",
      "country": "FRA",
      "firstName": "Anne-Fleur",
      "lastName": "Gélineau"
    },
    "items": [
      {
        "shareAmount": 1000,
        "shareItemAmount": 1000,
        "id": 24037,
        "amount": 1000,
        "type": "Membership",
        "state": "Canceled"
      },
      {
        "shareAmount": 500,
        "shareItemAmount": 500,
        "id": 24038,
        "amount": 500,
        "type": "Donation",
        "state": "Canceled"
      }
    ],
    "cashOutState": "Transfered",
    "paymentReceiptUrl": "https://www.helloasso-sandbox.com/associations/lasercutaddict2/adhesions/adhesion-2025/paiement-attestation/24037",
    "id": 16201,
    "amount": 1500,
    "date": "2024-07-31T15:40:35.0179115+02:00",
    "paymentMeans": "Card",
    "installmentNumber": 1,
    "state": "Authorized",
    "meta": {
      "createdAt": "2024-07-31T15:40:14.4785997+02:00",
      "updatedAt": "2024-07-31T15:43:35.25+02:00"
    },
    "refundOperations": [
      {
        "id": 492,
        "amount": 1500,
        "amountTip": 350,
        "status": "Refused",
        "meta": {
          "createdAt": "2024-07-31T15:43:25.673653+02:00",
          "updatedAt": "2024-07-31T15:43:35.196736+02:00"
        }
      }
    ]
  },
  "eventType": "Payment"
}

Les Notifications 📨

Recevoir des notifications

📘
Tester les notifications

Vous êtes une association

Vous êtes un partenaire

Exemple : Url de notification globale

Exemple : Url de notification dédié à une association

Type de notification

Indisponibilité de votre site

Vérifier l'authenticité de la notification

Exemples de notifications

Paiement autorisé sur un formulaire de don

Paiement autorisé sur un checkout

Commande créé sur un formulaire de don

Commandes créé sur un paiement checkout avec des échéances

Formulaire de don créé

Changement de nom d'une association

Paiement remboursé

Paiement contesté

Remboursement échoué

Recevoir des notifications

📘Tester les notifications

Vous êtes une association

Vous êtes un partenaire

Exemple : Url de notification globale

Exemple : Url de notification dédié à une association

Type de notification

Indisponibilité de votre site

Vérifier l'authenticité de la notification

Exemples de notifications

Paiement autorisé sur un formulaire de don

Paiement autorisé sur un checkout

Commande créé sur un formulaire de don

Commandes créé sur un paiement checkout avec des échéances

Formulaire de don créé

Changement de nom d'une association

Paiement remboursé

Paiement contesté

Remboursement échoué

📘
Tester les notifications