ledger-account-credited

ledger-account-credited tells you that money was added to one of the ledger accounts that fund your payouts.

When it fires

• Once for each credit to a ledger account listed on your payor account in Get Payor. For example, when your funding arrives, or when money from a returned or cancelled payment goes back to the account.
• It does not fire for debits.

What to do

• Record the credit, using amountCredited.
• If you hold payments until you have funds, submit them now.
• Do not read ledgerBalance as the balance right after this credit. It is the balance when the webhook was sent, which already includes any later credits and debits. Call Get Payor for the current balance.

Payload

Amounts use the Money object.

Example

The full request body Payment Labs sends:

{
  "payorId": "C-01JBX2Q8F4H6K8M0N2P4R6T8VW",
  "event": "ledger-account-credited",
  "timestamp": "2026-03-13T17:20:05.664Z",
  "data": {
    "amountCredited": {
      "value": 25000,
      "wholeValue": 2500000,
      "currency": "USD",
      "formattedValue": "$25,000.00",
      "digits": 2
    },
    "ledgerBalance": {
      "value": 31840.5,
      "wholeValue": 3184050,
      "currency": "USD",
      "formattedValue": "$31,840.50",
      "digits": 2
    },
    "ledgerAccountId": "01JB2Y7X6W5V4U3T2S1R0Q9P8N"
  }
}