Go-live checklist

  • Credentials stored in a secret manager, not in git
  • GET /v1/accounts and GET /v1/balance succeed
  • Webhook URL is HTTPS; signingSecret saved from the PUT that created it
  • Signature verification uses the raw body and rejects a stale t
  • Handlers are idempotent on event id
  • Payouts send a unique idempotencyKey per intended transfer
  • Payouts and declarations send a customer object, and a given account always uses one customerReference per currency
  • Every declaration sends exactly one of accountId or receivingIban, naming the vIBAN you expect the money on
  • Declarations send a unique idempotencyKey per expected payment
  • Your handler reads matchStatus and depositId on transaction.incoming
  • Your transaction list treats status=pending rows as open declarations, not as booked credits
  • Your handler tolerates deposit.expired and reads customer.customerId and customer.customerReference
  • Nothing you run reads feeAmount from transaction.incoming
  • A key that sets the webhook holds unrestricted read on transactions, payouts and deposits
  • Reads are paced for 20 a minute, not 60
  • 410 is reserved for a permanently retired URL
  • Sandbox (vbk_test_) proven before production (vbk_live_) keys are used

Did this page help you?