Notification/create webhook
UNIPaaS provides your platform with a single webhook that can be used specifically to trigger notifications to your vendors from your system.
In case you are using the UNIPaaS Notifications web-embed, all the below notifications will be automatically handled by the UI component for you.
Included notifications
The notification/create webhook will notify your platform about every significant event that is related to your vendors, use the notification/create webhook notifications to update your vendors about important events, such as
- Payment Received
- Payment settled (reconciled)
- Payout Completed
- Vendor account is fully approved
- Vendor account is in Review
- Vendor can start accepting limited payments
- Action is required to complete onboarding
- Account rejected
- Limit reminders (Time and value limits)
- Chargeback received
- Chargeback cancelled
- Payout failed
The
notification/createwebhook is made specifically to send notifications to your venders. Other webhooks are used for technical notifications, such as payment status, onboarding completion etc..
Sending your notifications
Each notification/create webhook notification includes fields that will help you both filter the messages you would like to forward to your vendor, and have a ready-to-use copy for those messages.
The following fields are included with every notification/create webhook message:
| Field name | Description |
|---|---|
| vendorId | The id of the vendor this message refers to |
| group | Notification group name, which helps filter out certain types of notifications |
| importance | Importance of the message to the vendor according to UNIPaaS |
| actions[] | The suggested CTA that should be added with each email or notification |
| subject | Suggested subject for sending this notification as an email |
| body | Suggested body for sending this notification as an email |
| Notification message | Suggested notification copy for sending this as an in-app notification |
| notificationId | A unique number that represents each notification which helps filter out specific notifications |
| data [] | A list of dynamic variables that were used in the suggested copy. Use these to write your own copy |
Example
The following is an example for a notification/create webhook notification (A vendor has accepted a payment)
{
"merchantId": "624c567dfcb8645744c7a881",
"vendorId": "624c567dfcb81g5744c7a881",
"vendorEmail": "[email protected]",
"subject": "A payment of 10 GBP was received for invoice #100456 ",
"body": "You have received a card payment of 10 GBP of invoice #<a href=\\\"invoiceUrl\\\">100456</a>.\n\Pay",
"data": {
"invoiceReference": "100456",
"paymentMethod": "card",
"pendingAmount": 0,
"currency": "GBP",
"brandName": "Pay"
},
"importance": "low",
"notificationId": "629",
"domEvent": "PaymentReceived",
"actions": [
{
"text": "View payment",
"severity": "info",
"payload": {
"action": "payPortal",
"method": "event",
"actionPayload": {
"queryParam": "page=Payments"
}
}
}
],
"group": "payments"
}
List of notifications
Onboarding
| Notification trigger | Message text (Email structure) | CTA |
|---|---|---|
| Vendor can start accepting payments | Your account is ready! You can now accept payments You can now accept payments from your customers for up to a total amount of {{payinVolumeLimit}}. Complete your registration in order to enable payouts and lift any limitations on payment acceptance. Your Sponsored Merchant Service Agreement is available {{here}}. {{brandName}} | completeOnboarding |
| Vendor's application is in review. | Your account application is being reviewed Thank you for completing your registration. Your account information is being reviewed. This can take up to 48 hours. You will be updated once the review is complete. Please note that we might ask for additional documents to fully activate your account. {{brandName}} | None |
| Vendor's application was approved | Your {{brandName}} account is fully activated! We are happy to inform you that your {{brandName}} account was approved and is fully activated! You can now both take payments and pay them out to your bank account. {{brandName}} | None |
| Additional information is needed to approve a vendor's application | Additional information is required to complete your registration Please re-submit the following information: {{filedName}} {{reason}} You can add the missing information now by clicking {{this registration page link}}. {{brandName}} | completeOnboarding |
| Vendor's application was rejected | Your {{brandName}} account has been permanently suspended Your account was reviewed by {{brandName}} and it was not approved for further use. Therefore, your {{brandName}} account has been permanently suspended. For more information, please contact {{supportEmail}} {{brandName}} | None |
| Amount limit warning for vendors who are accepting payments while their application is not yet approved (Notification will trigger once vendor reached 50% and 100% of the limit) | You have reached {{%}} of your {{limitAmount} {{currency}} payment acceptance limit You have reached {{%}} of your payment acceptance limit. {{Complete your registration}} in order to enable payouts and lift your limit. {{brandName}} | completeOnboarding |
| Time limit warning for vendors who are accepting payments while their application is not yet approved (Notification will trigger after 10, 20 and 30 days have passed) | Complete your registration within {{remainingDays}} days You have {{remainingDays}} days remaining to keep accepting payments, or until you reach a total amount of {{payinVolumeLimit}}. {{Complete your registration}} in order to enable payouts and lift your payment acceptance limits.{{brandName}} | completeOnboarding |
Note: Amount and time limit messages may present different messages when vendors are close to hitting a limit.
Accepting payments and paying out
| Notification trigger | Message text (Email structure) | CTA |
|---|---|---|
| Vendor has received a payment | A payment of {{amount}} {currency}} was received for invoice #{{invoiceUrl}} You have received a card payment of {{amount}} {currency}} of invoice #{{invoiceUrl}}. {{brandName}} | View Invoice |
| A payment has finished processing and is now ready to be paid out. | A payment is ready to be paid out The payment for invoice #{{invoiceUrl}} was settled successfully and is now ready to be paid out to your bank account. {{brandName}} | View Payment |
| A payout was made to a vendor's bank account | A payout of {{amount}} {{currency}} was made to your bank account. The following invoices are included in the payout: Invoice #{{InvoiceNumber}} Invoice #{{InvoiceNumber}} Payout id: {{payoutId}} {{brandName}} | View Payment |
| A Payout failed to process | A payout to your bank account has not been processed There was an error while transferring a payout of {{amount}} {{currency}} to your bank account. The money has been returned to your {{brandName}} account. For additional information, please {{contact support Email}}". Payout id: {{payoutId}} {{brandName}} | Contact Support |
| A Checkout was not created because it exceeds max transaction limit during registration | Payment attempt failed - complete onboarding to avoid future disruptions We regret to inform you that the payment attempt from {{buyerName}} has failed due to exceeding the remaining limit of your {{brandName}} account. Payment attempt details: Amount: {{amount}} {{currency}} Date: {{paymentDate}} Reference: {{reference}} Remaining limit: {{remainingLimit}} To ensure smooth payment processing going forward, you should complete the registration process. {{Complete your registration}} If you have any questions or need assistance, please don't hesitate to contact our support team at {{supportEmail}}. | |
| Chargeback notification received | One of your customers has filed a dispute for a payment Your customer {{customerEmail}} has filed a dispute for the {{creditCard}} payment {{#if invoiceUrl}} of invoice #{{invoiceId}}. The disputed amount may be deducted from your account while it is reviewed. You will be notified of the final decision once the review is complete. Please contact {{supportEmail}} as soon as you can to learn more and provide your input. {{brandName}} | |
| A chargeback was dropped | A payment dispute filed by your customer was cancelled The dispute your customer {{customerEmail}} filed for the {{creditCard}} payment #{{invoiceUrl}} of invoice {{invoiceId} has been cancelled. {{brandName}} |
Direct Debit
| Notification trigger | Message text (notification structure) | CTA |
|---|---|---|
| Direct Debit is enabled for a vendor | Direct Debit is available! With the lowest fees out there, you can now start collecting payments with Direct Debit in {{brandName}}! | Learn more |
| A mandate was submitted by the buyer, but not yet approved by the bank | {{customerName}} has submitted their Direct Debit mandate | Track mandate status |
| When the mandate is approved and Direct Debit can be used | Your Direct Debit with {{consumerName}} has been set up and you can start collecting payments | View mandate |
| When a mandate is rejected by Bacs | {{consumerName}}'s Direct Debit mandate was not approved by their bank or Direct Debit provider | Contact customer mailto: {{customerEmail}} |
| When a mandate is cancelled by buyer | {{consumerName}} has cancelled their Direct Debit mandate | Contact customer mailto: {{customerEmail}} |
| When a mandate is cancelled by the vendor (per buyer request) | You have cancelled {{consumerName}}'s Direct Debit mandate. All outstanding collections will be cancelled and no further Direct Debit collections can be made. | View mandate |
| When a mandate is reinstated | The Direct Debit mandate for {{consumerName}} has been reinstated and is ready for use. | View mandate |
| When a collection has been made successfully | You’ve received a Direct Debit payment from {{consumerName}}! | View payment |
| When a collection has failed | A Direct Debit collection from {{consumerName}} has failed | Contact customer mailto: {buyer email} |
| When a chargeback (indemnity claim) has been made by the customer | A Direct Debit indemnity claim has been made by {{consumerName}} | |
| Direct Debit transaction limit exceeded | Direct Debit limit exceeded - your collection of {{invoiceAmount}} from {{consumerName}} (mandate reference {{mandateRef}}) was not processed. | Contact customer mailto: {buyer email} |
Updated over 1 year ago