PeptidesPayment Docs
Payment ContainerWebhook events

payment.container.succeeded

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.

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.succeeded

payment.container.refunded Webhook

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.

Create a cart from your storefront payload POST

Creates a cart from a fully computed payload for your custom storefront. All monetary values must be sent as integer minor units (cents for 2-decimal currencies, fils for KWD, BHD, OMR, JOD, and TND). See the Custom store guide for the full field contract.