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 je immediate_capture vypnuté.
  • Objednávka je zaúčtována (state: completed). Webhook se odešle jen pokud je immediate_capture zapnuté, 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 }