The Payment Method entity within "The HIVE" platform denotes a financial instrument used by individuals or businesses to manage fund transfers. These instruments facilitate both incoming and outgoing transactions.

All Payment Methods are tied to an Account in "The HIVE", linking each method to either a Consumer, Business, or Cardholder account. This ensures security while offering personalized financial management. Payment methods are versatile, capable of loading and withdrawing from wallets or directly funding transactions like international transfers or P2P activities through passthrough.

Payment Method typeCopied!

Card

This widely-accepted method encompasses types such as debit, credit, or prepaid cards, known for their convenience and ubiquity.

Card Payment Method status

Status	Description
ACTIVE	The card is verified and is operational for transactions.
FAILED	An attempt to process the card has failed.
EXPIRED	The card has reached its end-of-life and can't be used for further transactions.
REJECTED	The system has declined the card for use.
DELETED	The card has been removed from the system.

Fail Reasons for Cad Payment Methods

To provide clarity on the specific nature reasons why a payment method couldn't be added, the system uses a set of "fail reasons." These reasons aid in diagnosing problems and can guide users or administrators in resolving them.

Fail Reason	Description
CARD_TYPE_NOT_SUPPORTED	Card payment method type is not supported.
CARD_NAME_MISMATCH	The provided card name and the name registered in the issuer match don't match.
CARD_COUNTRY_NOT_ALLOWED	Card issued by a country that is not allowed in the program.
ISSUED_CARD_NOT_ALLOWED_AS_PM	A card issued by Alviere cannot be used as a payment method.

Bank

This method connects directly with bank accounts for transactions. Integrations like Plaid simplify the addition of bank-based payment methods, ensuring a seamless, yet secure, experience.

Bank Payment Method status

In order to provide users with a clear understanding of the state of their bank payment methods, various statuses have been designated. These statuses offer insights into the current functionality or conditions affecting a specific bank payment method.

Status	Description
ACTIVE	The bank account is verified and ready for transactions.
PROCESSING	The bank payment method is currently being verified.
FAILED	A transaction or verification attempt has failed.
DELETED	The bank payment method has been removed from the system.
REJECTED	The bank payment method was declined by the system.

Fail Reasons for Bank Payment Methods

Occasionally, bank payment methods may encounter issues that prevent a successful verification. To provide clarity on the specific nature of such setbacks, the system uses a set of "fail reasons." These reasons aid in diagnosing problems and can guide users or administrators in resolving them.

Fail Reason	Description
CUSTOM	A custom-defined failure reason, possibly specified by administrators or due to unique circumstances.
TRANSACTION_FAILED	The transaction associated with the bank failed due to some issues.
NEEDS_UPDATE	The bank details or method requires an update for successful processing.
ACCOUNT_MISMATCH	The details provided do not match with the bank's records.
INVALID_BANK_TYPE	The type of bank account provided is not supported.
INVALID_PUBLIC_TOKEN	The public token associated with the bank account is not valid.
BANK_FAILED	A verification on the bank account failed, such as the routing number being invalid.