Payment methods are bank accounts that can be reused for multiple payments. Money will be debited from payment methods when a payment request targeting the method is created and executed.
Payment method statuses
| Status | Description |
|---|---|
pending_agreement_acceptance | The method needs to be accepted by the bank account owner. This can be done either by sending a Setup Link to the owner or by using our Agreements API resource. |
pending_activation | The method will be picked up by our automated process and sent to the banking provider for registration. |
waiting_for_activation_response | The owner has accepted the payment method. The registration and charge files have been generated. The financial institution now needs to send a response regarding bank account information (OK or Not OK). |
active | The financial institution has successfully confirmed the bank account registration. The payment method can now be used for payment requests. Note: The status can change to inactive if the owner cancels or removes the payment method at the financial institution. |
error | The financial institution was not able to confirm the bank account registration (usually due to the owner providing incorrect bank account information or an error in the financial institution). |
inactive | The payment method cannot be used. This is usually due to the owner canceling their account and the financial institution informing us that the method is no longer valid. |
canceled | The payment method underlying registration with the banking network was canceled by the end user/customer. This will render the method useless since future payment requests will fail. This is something we aim to aliviate with the multi-bank rail we are building in the countries we operate, since underlying registrations are per-bank. |