Paga i webhook del commerciante

Pay fornisce gli eventi del ciclo di vita del pagamento al tuo endpoint HTTPS con x-lc-pay-* intestazioni. Questo è separato dai webhook dell'app API Core (X-Webhook-Signature) e il reindirizzamento mirror HMAC.

Configurazione del webhook API principale: Webhook API principali. Esempi di verifica della firma multilingue: Esempi di API (multilingue).

Tipi di eventi

• payment.confirmed — deposito completato (gestito dai venditori dell'evento di successo principale)
• payment.pending — pagamento ancora in elaborazione
• payment.failed, payment.canceled — fallimento/annullamento da parte dell'acquirente

I venditori di Production Mirror verificano x-lc-pay-signature, accetta payment.confirmed, quindi confermare con POST https://pay.licensechain.app/api/checkout/mirror/validate prima di contrassegnare il ordine locale pagato. Vedere API Mirror a pagamento.

Intestazioni di consegna del webhook del commerciante

• x-lc-pay-signature — Firma HMAC-SHA256
• x-lc-pay-event-id — ID evento univoco
• x-lc-pay-event-type — tipo di evento
• x-lc-pay-idempotency-key — chiave di deduplica
• x-lc-pay-timestamp — marca temporale firmata

Verifica della firma

Formato del messaggio per la convalida della firma:

{'{'}timestamp{'}'}.{'{'}rawJsonPayload{'}'}

Sono disponibili implementazioni in Node, Python, Go, PHP e Ruby Esempi di API (multilingue) (confronto a tempo costante consigliato).

Comportamento di consegna

• Le consegne riuscite vengono riconosciute dal tuo endpoint che restituisce una risposta 2xx.
• Le consegne non riuscite vengono ritentate automaticamente; trattare gli eventi come idempotenti utilizzando x-lc-pay-idempotency-key.
• Verifica sempre x-lc-pay-signature prima di agire su un evento.