Transaction Statuses

Depending on what happens, transactions go through several statuses. The below list provides you the definition of each transaction status you might come across when calling Meld APIs.

Status	Description	State
`PENDING CREATED`	The transaction has been created in Meld's system, but it has not yet been processed by the service provider.	TEMPORARY
`PENDING`	The transaction has been created in Meld's system and has been submitted to the service provider to be reviewed. Once it has been verified, the funds will be sent to the recipient.	TEMPORARY
`AUTHORIZED`	The transaction has been approved by the bank that issues the customer's payment card.	TEMPORARY
`AUTHORIZATION_EXPIRED`	Transactions that are expired were authorized but never submitted for capture. These transactions typically expire approximately 30 days after the initial authorization.	TEMPORARY
`SETTLING`	Fiat funds are being moved from your customer's bank through your account.	TEMPORARY
`SETTLED`	Transactions with this status have been approved and the customer's fiat funds have successfully settled.	TERMINAL
`REFUNDED`	A full refund has been successfully issue to your customer	TERMINAL
`DECLINED`	The payment method used for the transaction has been declined. If this transaction uses the card method, there are several reasons that the card may be declined, such as insufficient funds in the account, the card is not being activated, or the card is stolen or canceled.	TERMINAL
`CANCELLED`	The transaction has been canceled by the customer or account during the payment process. Any settling fiat funds will not be sent for settlement.	TERMINAL
`FAILED`	The transaction has failed. There are several reasons why a transaction has failed, the most common reasons for declines are: Do not Honor -- The bank is unwilling to accept the transaction. Insufficient Funds -- The account did not have sufficient funds to cover the transaction amount at the time of the transaction. Limit Exceeded -- The attempted transaction exceeds the withdrawal limit of the account. Expired Card-- Card is expired. The customer will need to use a different card. Invalid Card Number -- The customer entered an invalid payment method or made a typo in their card information. Invalid Expiration Date -- The customer entered an invalid payment method or made a typo in their card expiration date. Have the customer correct their payment information and attempt the transaction again – if the decline persists, they will need to contact their bank. Card Issuer Declined CVV -- The customer entered in an invalid security code or made a typo in their card information. Have the customer attempt the transaction again – if the decline persists, the customer will need to contact their bank. Based on Location -- The bank declined based on location. Bank’s Fraud Rules -- The bank's fraud rules blocked the transaction.	TERMINAL
`ERROR`	An error occurred while processing the transaction.	TERMINAL
`VOIDED`	The transaction has been terminated early in the payment life cycle and no fiat funds have moved.	TERMINAL