Webhook
Při registraci může obchodník zadat endpoint, který bude přijímat POST payload s webhooky obsahujícími stav objednávky.
Webhook se volá v těchto situacích:
- Checkout je přijat a objednávka je vytvořena (
state: approved) — bez stavu'approved'není možné provést/charge. Tento webhook se odešle jen pokud jeimmediate_capturevypnuté. - Objednávka je zaúčtována (
state: completed). Webhook se odešle jen pokud jeimmediate_capturezapnuté, nebo u produktu Zaplať ve třech. - Zákazník je při skóringu odmítnut (
state: cancelled) - Skóring selhal — neznámá chyba (
state: error) - Vypořádáno — Twisto převedl prostředky (
settled_date: <datum>) - Refundováno — objednávka je refundována (
refunded_amount: <Decimal>) - Zrušení — objednávka je zrušena (
state: cancelled)
Webhook může vypadat takto:
{
"checkout_id": ...,
"total_amount": ...,
"refunded_amount": ...,
"created_date": "2019-08-24T14:15:22Z",
"settled_date": "2019-08-26T14:15:22Z",
"type": "standard", # standard
"state": "approved", # approved (skóring přijat), cancelled (skóring zamítnut nebo zrušeno obchodníkem), error
"external_id": ... # ID transakce obchodníka
}