Below are all the IPNs (webhooks) that BlueSnap offers (separated by type) with the IPN name, description, and associated parameters. For a complete list of all parameters that are sent in IPNs, refer to the IPN parameter reference.
Default IPNs | On-Demand IPNs |
---|---|
Available automatically | Available in addition to the standard Default IPN types. To enable these refer to Enabling IPNs in BlueSnap. |
Default IPNs
IPN Name (Value of the transactionType parameter passed in the IPN) | Description | Parameters (Parameter Reference Guide) |
---|---|---|
AUTH_ONLY | Sent when an Authorization Only request is performed. Auth Only is a request to check whether a credit card is valid and has the funds to complete a specific transaction (i.e. purchase). It does not actually run a charge on the card, but does temporarily hold the funds aside. It can also be run with a 0 charge value. |
|
CANCEL_ON_RENEWAL | Sent when a customer requests to cancel a subscription that is set to auto renew. The subscription will be cancelled automatically at the end of the subscription period. |
|
CANCELLATION | Sent when a recurring charge is cancelled. The cancellation can be initiated by the customer, merchant, or BlueSnap. |
|
CANCELLATION_REFUND | Sent when a subscription is cancelled and a refund is processed. |
|
CHARGE | Sent when a new purchase has been completed. This applies to both one-time charges and recurring charges. |
|
CHARGEBACK | Sent when a shopper challenges a transaction with their issuing bank, who then initiates the chargeback process. This IPN (webhook) provides you the opportunity to address the issue. |
|
CHARGEBACK_STATUS_CHANGED | Sent when an event is received from Chargebacks911 that does not open a new chargeback. |
|
CONTRACT_CHANGE | Sent when the contract associated with a recurring charge or a subscription contract is replaced with another contract, such as a customer moving from one service plan to another. |
|
DECLINE | Sent when a transaction is rejected due to payment processing or review process. |
|
FAILED_PAYOUT_TRANSFER | Sent when a payout transfer fails. If you receive this notification, note the following:
|
|
MERCHANT_PARTNER_ONBOARDED | Sent when a platform partner onboards a new merchant. |
|
RECURRING | Sent when a charge has been made for a subscription contract. This applies only to the second and subsequent charges. The first payment of a subscription contract is treated as a standard charge and a CHARGE IPN is sent. |
|
REFUND | Sent when a refund is issued. |
|
SUBSCRIPTION_REMINDER | Sent each time a subscription reminder email should be sent to a shopper for renewal of their subscription. Using the information sent in the notification, you can generate your own email to send to your customer reminding them of their upcoming payment period for the subscription renewal. |
|
On-Demand IPNs
On-Demand IPNs are available in addition to the standard Default IPN types.
To enable these refer to Enabling IPNs in BlueSnap.
IPN Name (Value of the transactionType parameter passed in the IPN) | Description | Parameters (Parameter Reference Guide) |
---|---|---|
ACCOUNT_UPDATER | Sent when a card number or expiration date has been updated. |
|
CC_CHARGE_FAILED | Sent when a credit card payment for an initial charge fails (for both one-time and subscription purchases). Note: This does not apply to recurring charge failures. |
|
CC_STATUS_CHANGED |
Sent when the status of a shopper's stored card has changed. |
|
CHARGE_PENDING | Sent when an ACH or SEPA Direct Debit payment is initially received. Once the payment has been processed a CHARGE IPN will be sent. |
|
FRAUD_DECLINE | Sent when a transaction is declined due to fraud. |
|
OFFLINE_ORDER | Sent when an offline order (via Local Bank Transfer or Wire) is placed. |
|
PAYMENT_UPDATED | Sent when there is a successful update to a payment method. |
|
PAYMENT_UPDATED_FAILURE | Sent when an update to a payment method has failed. |
|
PAYOUT | Sent to the merchant each time BlueSnap issues a payout (deposit). Note: If there are insufficient funds to generate a payout, no payout notification is sent. |
|
SUBSCRIPTION_CHARGE_FAILURE | Sent when a recurring payment fails for a shopper's subscription. |
|
UNDER_VENDOR_REVIEW | Sent for each order if the merchant selected the "Review all orders" option in the general account settings. |
|
VENDOR_REPORT_AVAILABLE | Sent to the Marketplace Merchant when Payout Detail report is available for vendor. |
|
VENDOR_STATUS_CHANGED | Sent to the Marketplace Merchant on the following events:
|
|
Updated 18 days ago