| Code |
Name |
type |
Description |
| 1000 |
Invoice |
credit |
once an invoice reaches the "complete" status, the corresponding amount is credited to the merchant account in the selected settlement currency |
| 1004 |
Fee Refund |
credit |
|
| 1006 |
Exchange |
debit & credit |
This entry indicates that BitPay transfered your balance from one ledger currency (recorded as a debit) to another ledger currency (recorded as a credit). This typically happens if a merchant needs to change settlement currency and exchange the pending balance from one currency to another |
| 1007 |
Exchange Fee |
debit |
|
| 1008 |
Plan Charge |
debit |
For merchants on a legacy SaaS plan, this entry is used to debit the merchant account with the monthly fee |
| 1009 |
Plan Prorated Credit |
credit |
For merchants on a legacy SaaS plan, this entry is used to adjust the amount charged. |
| 1010 |
Plan Underutilization Credit |
credit |
For merchants on a legacy SaaS plan, this entry is used to adjust the amount debited (account not used) |
| 1011 |
Payoff Negative Balance |
debit & credit |
This entry does not have any additional fields. It corresponds to an automatic transfer made by BitPay from one ledger currency to another. Typically to cover refund or payouts. For instance, if you execute a refund request where EUR is the base currency but your active ledger (linked to the settlement currency) is in USD, you will see such "Payoff Negative Balance" entry appear on both ledger (a debit on the USD ledger and a credit) |
| 1012 |
Donation |
credit |
|
| 1016 |
Custom |
debit & credit |
Code used by BitPay for general purpose custom entries. It may be use to correct an invalid entry on your ledger |
| 1017 |
Account Settlement |
debit |
This entry is written to debit the merchant balance for a given account settlement |
| 1020 |
Invoice Refund |
debit |
This entry is written once a refund request made on an invoice is executed. The merchant balance is debited with the refund amount requested. |
| 1022 |
Corrective for Failed Account Settlement |
credit |
Indicates a previous settlement failed (for instance invalid settlement info). In such scenario BitPay credits the amount back to the merchant account using this ledger code. |
| 1023 |
Invoice Fee |
debit |
Once an invoice reaches the "complete" status, the corresponding fee is credited using this ledger code |
| 1024 |
Bitcoin Deposit |
credit |
|
| 1025 |
Fiat Deposit for Payout |
credit |
When a merchant makes a bank transfer to BitPay in order to fund the consumer payout/withdrawal activity, the deposited amount is credited to the merchant account using this ledger code |
| 1026 |
Donation Fee |
debit |
|
| 1027 |
Custom Fee |
debit |
|
| 1030 |
Affiliate Commission |
credit |
For merchants who onboarded business under their referral link, the commissions are credited to the account using this ledger code |
| 1031 |
Manual Affiliate Commission |
credit |
|
| 1032 |
Merchant Card Deposit |
debit |
|
| 1033 |
Custom Plan Charge |
debit |
|
| 1034 |
Funding Payout |
debit |
This entry is written once BitPay sets a payout to the status funded. This means that part of the merchant balance has been allocated to execute a payout. |
| 1035 |
Manually Funding Payout |
debit |
|
| 1036 |
Custom Fee Reimbursement |
credit |
|
| 1037 |
Custom Plan Charge Reimbursement |
credit |
|
| 1038 |
Testnet Bitcoin Settlement |
debit |
Testnet BTC/BCH settlements (test.bitpay.com) are recorded using this ledger code |
| 1039 |
Refund Fee |
debit |
This entry will be immediately written next to the "Invoice Refund". The refund fee is the actual cost of broadcasting the refund transaction on the selected blockchain |
| 1040 |
Payout Fee |
debit |
This entry is written once BitPay sets a payout to the status funded. This is the fee charged for each payout executed |
| 1041 |
Wire Fee |
debit |
|
| 1048 |
Fiat Deposit for Refund |
credit |
When a merchant makes a bank transfer to BitPay in order to cover pending refund requests. |
| 1050 |
Immediate Invoice Refund |
debit |
This entry is written once an immediate refund request made on an invoice is created. The merchant balance is debited with the refund amount requested. |
