Skip to main content
Webhooks are currently sent for the following events.
ResourcePayload nameDescription
API key pairapi-key-pair.createdAn API key pair was created.
API key pairapi-key-pair.updatedAn API key pair was updated.
API key pairapi-key-pair.deletedAn API key pair was deleted.
Buyerbuyer.createdA buyer was created successfully.
Buyerbuyer.updatedA buyer was updated successfully. This does not include its shipping details, see shipping-details.deleted.
Buyerbuyer.deletedA buyer was deleted.
Capturecapture.pendingAn individual capture against a transaction is pending. Sent per capture, including when a transaction has more than one capture.
Capturecapture.succeededAn individual capture against a transaction succeeded.
Capturecapture.declinedAn individual capture against a transaction was declined by the payment service.
Capturecapture.failedAn individual capture against a transaction failed due to an internal or external reason.
Gift cardgift-card.deletedA stored gift card was deleted.
Monitoring incidentmonitoring.incident.createdA monitoring incident has been created.
Monitoring incidentmonitoring.incident.closedA monitoring incident has been closed.
Payment methodpayment-method.pausedA stored payment method (for example card) was paused.
Payment methodpayment-method.resumedA stored payment method (for example card) was resumed.
Payment methodpayment-method.updatedA stored payment method (for example card) was updated, likely due to an account update.
Payment methodpayment-method.authorization-expiringThe underlying agreement or mandate for a stored payment method is close to expiring.
Payment methodpayment-method.authorization-update-requiredThe underlying agreement or mandate for a stored payment method has expired and needs reauthorization.
Payment methodpayment-method.authorization-updatedThe underlying agreement or mandate for a stored payment method is no longer expired or expiring because it was reauthorized.
Payment methodpayment-method.deletedA stored payment method (for example card) was deleted, likely due to an update from the payment service.
Refundrefund.declinedA refund for a transaction was declined by the payment service.
Refundrefund.failedA refund for a transaction was otherwise rejected by the payment service.
Refundrefund.pendingA refund for a transaction is pending.
Refundrefund.succeededA refund for a transaction succeeded.
Report executionreport-execution.failedA report failed to generate. You might need to re-create the report.
Report executionreport-execution.succeededA report was generated.
Shipping detailsshipping-details.createdA buyer successfully had its shipping details added.
Shipping detailsshipping-details.updatedA buyer’s shipping details were updated successfully.
Shipping detailsshipping-details.deletedA buyer’s shipping details were deleted.
Transactiontransaction.authenticatedA transaction was successfully authenticated.
Transactiontransaction.authentication-pendingA transaction is pending authentication.
Transactiontransaction.authorizedA transaction is authorized (through 3DS or otherwise) but has not yet been authenticated.
Transactiontransaction.capture-failedAn authorized transaction failed to capture.
Transactiontransaction.capture-pendingAn authorized transaction is pending capture.
Transactiontransaction.capturedAn authorized transaction was captured.
Transactiontransaction.declinedA transaction was declined.
Transactiontransaction.failedA transaction failed due to an internal or external reason. Please check the error_code for the cause.
Transactiontransaction.review-acceptedA transaction that was held in anti-fraud review has been accepted but its status has not changed, only the pending_review property has been set to false.
Transactiontransaction.settledA transaction has been reported settled. This is currently only supported by The Giving Block.
Transactiontransaction.void-declinedAn authorized transaction had its request to void the authorization declined by the payment service.
Transactiontransaction.void-failedAn authorized transaction had its request to void the authorization otherwise rejected by the payment service.
Transactiontransaction.void-pendingAn authorized transaction has a pending void request.
Transactiontransaction.voidedAn authorized transaction has been voided.
Payoutpayout.succeededA payout has been created successfully.
Payoutpayout.pendingA payout is pending a notification from the payment service.
Payoutpayout.declinedA payout was declined.
Payoutpayout.failedA payout failed due to an internal or external reason.
Payment linkpayment-link.createdA payment link has been created successfully.
Payment linkpayment-link.updatedA payment link has been updated or expired.
Additional webhooks covering all the remaining events in the payment lifecycle are planned for a very near release.