PeptidesPayment Docs
Payment ContainerWebhook events

payment.container.refunded

Fired when a refund (full or partial) is processed for a container order. external_order_id is echoed when the merchant has registered it via /webhooks/payment-container/order-created.

Header Parameters

X-Signature*string

HMAC-SHA256 of the raw request body using your shared secret. Format: sha256=<64-hex>.

X-Timestamp*string

Unix epoch seconds at which the envelope was signed. Reject if skew > 5 minutes.

X-Request-Id*string

UUID v4. Use to dedupe redelivered events.

X-Event-Name?string

Echoed event name (also present inside the envelope as event_name).

Request Body

application/json

Outbound webhook payload posted to the merchant's configured webhook_url.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

Example Requests

POST/payment.container.refunded

payment.container.failed Webhook

Fired when a payment_container payment fails terminally (card declined, BNPL rejected, etc.). No order is created on our side.

payment.container.succeeded Webhook

Fired when a payment_container payment is captured. The merchant should create their order on receipt and call POST /webhooks/payment-container/order-created with the resulting external_order_id.