Partner Webhooks

Paynote sends partner webhook events to notify your system of key updates during the merchant onboarding and lifecycle process. These events help you track application progress, approval status, and account changes in real time.

Onboarding Status Events

Event NameDescription
Pending Bank StatementA bank statement has been uploaded and is awaiting underwriting review.
OnboardingThe merchant is filling out the business application via the Paynote dashboard.
VerifiedThe merchant has been conditionally approved by underwriting.
App SentThe Paynote ACH agreement has been sent to the merchant.
App ReceivedThe merchant has completed and signed the agreement.
RetryThe merchant has pending items to resolve before onboarding can proceed.
DeclinedThe merchant application was not approved.

Merchant Status Events

Event NameDescription
OnboardedThe merchant has been fully set up and assigned to a pricing plan.
LiveThe merchant has started processing transactions.
IntegratingThe merchant is currently working on API integration.
InactiveThe merchant hasn't processed any payments in the past 7 days.
CanceledThe merchant’s account has been terminated.
SuspendedThe account is temporarily restricted due to an issue.

Example Payload

{
  "event": "partner.deal.status.updated",
  "user": {
    "name": "Matilda Navarro",
    "email": "[email protected]",
    "phone": "1122334455",
    "deal_status": "App Received",
    "deal_status_type": "App",
    "created_at": "2024-04-26"
  },
  "timestamp": "2024-04-26T14:13:24Z"
}