Signed payload Conomy sends to your configured webhook URL when a transaction status changes.
Objects
Webhook configuration object
Default webhook URL.
defaultcvu.staticcvu.dynamicdefaultcvu.staticcvu.dynamicPer-flavor webhook URLs keyed by flavor.
Webhook event object
payment.createdpayment.authorizedpayment.capturedpayment.receivedpayment.settledpayment.unsettledpayment.expiredpayment.failedpayment.refundedpayment.requiresReviewpayment.attemptedpayment.amountMismatchpayment.underpaidpayment.overpaidpayment.pendingAssignmentpayment.reviewApprovedpayment.reviewRejectedpayment.reviewResolvedpayment.refund.createdpayment.refund.settledpayment.refund.failedcustomer.levelChangedpayment.statusChangedOptional raw discriminator that produced the eventType, for example attempted, settled, or refundCreated.
Transaction snapshot included in a webhook delivery.
idstringrequiredUnique identifier of the Conomy transaction.
externalIdstringExternal identifier provided by the merchant or provider.
totalAmountstringTotal amount processed for the transaction.
currencystringSpecifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
productstringCanonical purchaseCurrency:currency pair for the transaction, for example ARS:ARS or ARS:USDT.
purchaseAmountstringAmount paid by the payer in purchaseCurrency.
purchaseCurrencystringSpecifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
statusstringrequiredCREATEDATTEMPTPENDINGAUTHORIZEDPENDING_CAPTUREDCAPTUREDRECEIVEDSETTLEDUNSETTLEDEXPIREDFAILEDREQUIRES_REVIEWREFUNDEDtypestringdescriptionstringTransaction description when provided by the payment flow.
parentPaymentIdstringrelatedPaymentIdstringsettledAtstringdate-timeexpiredAtstringdate-timeunsettledAtstringdate-timeunsettledReasonstringsettlementBatchIdstringdocumentationStatusstringPENDING_UPLOADUPLOADEDAPPROVEDREJECTEDSENTcustomerIdstringoriginatorobjectPayer/originator details. For CVU deposits, bankAccount and cvu carry the payer-side account number when the originating rail provides it. clearinghouseId is optional and may appear on any rail that exposes a clearinghouse reference; availability depends on the rail.
idstringemailstringemailWebhook transaction object
Unique identifier of the Conomy transaction.
External identifier provided by the merchant or provider.
Total amount processed for the transaction.
Specifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
Canonical purchaseCurrency:currency pair for the transaction, for example ARS:ARS or ARS:USDT.
Amount paid by the payer in purchaseCurrency.
Specifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
CREATEDATTEMPTPENDINGAUTHORIZEDPENDING_CAPTUREDCAPTUREDRECEIVEDSETTLEDUNSETTLEDEXPIREDFAILEDREQUIRES_REVIEWREFUNDEDTransaction description when provided by the payment flow.
PENDING_UPLOADUPLOADEDAPPROVEDREJECTEDSENTPayer/originator details. For CVU deposits, bankAccount and cvu carry the payer-side account number when the originating rail provides it. clearinghouseId is optional and may appear on any rail that exposes a clearinghouse reference; availability depends on the rail.
Signed payload Conomy sends to your configured webhook URL when a transaction status changes. This callback is delivered to your application; you do not call this endpoint against the Conomy API. If you configured a secretKey, verify the X-Webhook-Signature header before processing the event.
transactionStatusChangedHeaders
HMAC-SHA256 hex digest of the raw request body, present when a secretKey is configured.
Payload required
Transaction status event delivered to the client webhook URL.
payment.createdpayment.authorizedpayment.capturedpayment.receivedpayment.settledpayment.unsettledpayment.expiredpayment.failedpayment.refundedpayment.requiresReviewpayment.attemptedpayment.amountMismatchpayment.underpaidpayment.overpaidpayment.pendingAssignmentpayment.reviewApprovedpayment.reviewRejectedpayment.reviewResolvedpayment.refund.createdpayment.refund.settledpayment.refund.failedcustomer.levelChangedpayment.statusChangedOptional raw discriminator that produced the eventType, for example attempted, settled, or refundCreated.
Transaction snapshot included in a webhook delivery.
idstringrequiredUnique identifier of the Conomy transaction.
externalIdstringExternal identifier provided by the merchant or provider.
totalAmountstringTotal amount processed for the transaction.
currencystringSpecifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
productstringCanonical purchaseCurrency:currency pair for the transaction, for example ARS:ARS or ARS:USDT.
purchaseAmountstringAmount paid by the payer in purchaseCurrency.
purchaseCurrencystringSpecifies the currency used, following the ISO 4217 standard for fiat currencies (e.g., CLP, ARS, MXN). Go to the currencies page for the complete list of supported values.
statusstringrequiredCREATEDATTEMPTPENDINGAUTHORIZEDPENDING_CAPTUREDCAPTUREDRECEIVEDSETTLEDUNSETTLEDEXPIREDFAILEDREQUIRES_REVIEWREFUNDEDtypestringdescriptionstringTransaction description when provided by the payment flow.
parentPaymentIdstringrelatedPaymentIdstringsettledAtstringdate-timeexpiredAtstringdate-timeunsettledAtstringdate-timeunsettledReasonstringsettlementBatchIdstringdocumentationStatusstringPENDING_UPLOADUPLOADEDAPPROVEDREJECTEDSENTcustomerIdstringoriginatorobjectPayer/originator details. For CVU deposits, bankAccount and cvu carry the payer-side account number when the originating rail provides it. clearinghouseId is optional and may appear on any rail that exposes a clearinghouse reference; availability depends on the rail.
idstringemailstringemailExpected response from your URL