Cancel-endpointen används när en användare vill återkalla en e-sign. Upsales anropar den i två fall:
- Användaren klickar på Återkalla e-sign på e-signen.
- Användaren raderar e-signen. E-signen tas bort från Upsales innan /cancel anropas.
Direkt efter ett lyckat /cancel anropar Upsales appens /delete-endpoint med samma body, så din app måste implementera båda. Upsales anropar bara /cancel när e-signen har ett documentId (som inte är "0").
Endpoint POST https://yourapp.com/cancel
Endpointen måste använda HTTPS.
Body
Request body.data innehåller documentId för den e-sign som ska avbrytas (body.data.documentId).
Svar
Svara med status 200 eller 201. Svarets body används inte. Som standard väntar Upsales 30 sekunder på svaret.
Alla andra statuskoder, eller inget svar i tid, stoppar flödet: Upsales anropar inte /delete, och en återkallad e-sign behåller sin nuvarande status i Upsales.