1.4 KiB
BIP-70 Modifications
In addition to JSON payment protocol, BitPay Bitcoin, Bitcoin Private, and Bitcoin Cash invoices use a mildly modified version of BIP-70. We include one additional field which specifies the fee rate the transaction must have in order to be accepted. This minimum fee is required to ensure a reasonable confirmation time for payments which are sent to BitPay. To further ensure this we also require payments be made with confirmed inputs. Payments using unconfirmed inputs, such as unconfirmed change, will be rejected.
Since RBF payments can be modified after they are broadcast, they will also be rejected by our payment protocol server. Make sure to disable the RBF flag for any transactions sent to BitPay.
required_fee_rate- The minimum fee per byte required on your transaction. Payments will be rejected if fee rate included for the transaction is not at least this value. May be fractional value ie 0.123 sat/byte
Application Logic
Please note that you should NOT broadcast a payment to the P2P network if we respond with an http status code other than 200. Broadcasting a payment before getting a success notification back from the server will
lead to a failed payment for the sender. The sender will bear the cost of paying transaction fees yet again to get their money back.