Lors de la configuration de votre transaction, vous pouvez définir un délai dans lequel un participant doit effectuer son action. Si ce participant reste inactif au-delà de la période que vous avez définie, nous vous enverrons une alerte par email. L’action du participant, ainsi que la transaction, seront signalées comme stalled. Ce délai peut être défini via l’endpoint POST /v1/transactions/{transaction_id}/participants avec l’argument stall_trigger, qui doit être exprimé en heures.
curl
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE/participants \
-d [email protected] \
-d stall_trigger=72
Si le participant n’effectue pas son action dans le délai imparti, l’API renvoie un objet transaction avec le paramètre stalled défini sur true ainsi qu’un stalled_reason. Pour la liste complète de toutes les raisons de blocage possibles, consultez la Liste de toutes les raisons possibles de blocage.
{
"object": {
"participant_email": "[email protected]",
"action_id": "act_oX393gobbrK31",
"transaction_id": "tx_Y0K9egJm6VBL",
"stalled_reason": "signature_refusal"
}
}
Notez que le statut stalled n’a aucun effet sur le flux de la transaction. Universign se contente de vous avertir (nous ne bloquons pas le participant ni n’annulons la transaction de notre côté) : c’est à vous qu’il revient de prendre les mesures appropriées (manuellement ou à l’aide de webhooks).
