Fiat Funding Onramp Error Codes
Bakkt Transfer API error codes
| Type | Description | Error Explanation |
|---|---|---|
| PARTY_SUSPENDED | Party Suspended | The consumer account is suspended |
| IDEMPOTENCY_KEY_IN_USE | IDEMPOTENCY_KEY_IN_USE | Idempotency key was used previously |
| INVALID_PARTNER_ID | The Partner Id is not valid | PartnerID is not correct |
| PARTY_ACCOUNT_NOT_FOUND | Partner Party Ref not found | An existing consumer account was not found |
| PARTNER_INVALID_OPERATION | Partner operation not permitted: FUND_TRANSFER | Partner account created but does not have service type set up |
| PARTY_INVALID_OPERATION | Party status not valid | The consumer status is not active |
| PLAID_ACCOUNT_NOT_FOUND | No active plaid account found | A corresponding Plaid account was not found for the consumer. Bank Link issue |
| OPERATION_NOT_ALLOWED | Ach bank transaction is not allowed | The consumer is not allowed to transfer funds |
| BANK_ACCOUNT_NOT_FOUND | Active bank account not found for party | No linked bank account found for Consumer |
| BANK_LINK_ITEM_NOT_FOUND | No associated plaid item found for id 34DSFWE456 | The consumer's Plaid account link may have expired or the user never linked an account |
| LINKED_BANK_ACCOUNT_NOT_FOUND | Active bank account not found for party | No linked bank account found for Consumer |
| BANK_INSTITUTION_NOT_FOUND | Failed to find table PLAID_ITEM record with id 1AFB456 | The Bank / Institution provided by Plaid cannot be found. A re-link needs to be initiated |
| UNSUPPORTED_FINANCIAL_INSTITUTION | Financial Institution provided is unsupported at this time. | The consumer Bank is not supported by Bakkt |
| STORED_AUTH_INVALID | The current link status is not active | Plaid link status is not valid, bank account relinking needed |
| INVALID_FIELD_VALUE | The amount is below the minimum withdrawal amount of $10. | The transaction request amount is below the minimum value |
| INSUFFICIENT_BALANCE | The account does not have enough available balance for action of value 50 dollars | Operation was rejected because the account had insufficient balance |
| BANK_ACCOUNT_BLOCKED | The operation is not allowed | The bank account is on blocked list |
| BANK_ACCOUNT_BALANCE_UNAVAILABLE | Bank account provider returned no balance information. | No balance account data on bank account |
| RISKY_EVENT_DECLINED | Unable to process the deposit request | The event was determined risky and declined |
| PARTNERPARTYREF_NOT_UNIQUE | Partner Party Ref not unique | partnerPartyRef was used previously |
| SYSTEM_ERROR | SYSTEM_ERROR | Unknown error |
| PARTNER_NOT_IN_HIERARCHY | PERMISSION_DENIED | Invalid access |
| INVALID_PARTNER_STATUS | PARTNER_INVAID | Invalid access |
| TRANSACTION_VELOCITY_OVER_LIMIT | Maximum number of deposit transactions reached | The consumer has reached their daily limit for that operation |
| AMOUNT_OVER_LIMIT | The requested amount would exceed the transaction limit. | The transaction amount has exceeded the max amount |
| AMOUNT_OVER_LIMIT_DAILY | The requested amount would exceed the transaction limit. | This transaction amount has exceeded daily transaction limit |
| AMOUNT_OVER_LIMIT_MONTHLY | The requested amount would exceed the transaction limit. | This transaction amount has exceeded monthly transaction limit |
Bakkt Transaction Retrieval API Error Codes
| Http status | Type | Sample response | Error Explanation |
|---|---|---|---|
| 400 | VALIDATION_ERROR | {"type": "VALIDATION_ERROR","description": "Data provided was invalid for operation.","detail": "PARTNER_ID_NOT_VALID_FOR_TRANSACTION"} | Invalid PartnerId |
| 400 | INVALID_DATA | {"type": "INVALID_DATA","description": "Data provided was invalid for operation.","detail": "Partner Party Link not found"} | Data provided was invalid for operation |
| 400 | INVALID_OPERATION | {"type": "INVALID_OPERATION","description": "Operation is not supported.","detail": "Party operation not permitted: "} | Operation is not supported. |
| 400 | INVALID_OPERATION | {"type": "INVALID_OPERATION","description": "Operation is not supported.","detail": "Party status not valid: "} | Operation is not supported. |
| 404 | NOT_FOUND | {"type": "NOT_FOUND", "description": "Item is not found for specified id.","detail": "Transaction not found {{transactionId}}"} | Item is not found for specified id. |
Bakkt Account Link And Add Bank Account API Error Codes
| Http status | Type | Sample response | Error Explanation |
|---|---|---|---|
| 400 | PARTY_INVALID_OPERATION | {"type": "PARTY_INVALID_OPERATION","description": "Operation is not supported.","detail": "Party status not valid"} | The consumer status is not active |
| 404 | PARTY_ACCOUNT_NOT_FOUND | { "type": "PARTY_ACCOUNT_NOT_FOUND", "description": "Data provided was invalid for operation.", "detail": "Partner Party Ref not found" } | An existing consumer account was not found |
| 400 | INVALID_PARTNER_ID | { "type": "INVALID_PARTNER_ID", "description": "Request parameters didn't pass their validation", "detail": "The Partner Id is not valid" } | PartnerID is not correct |
| 403 | LINK_LIMIT_EXCEEDED | { "type": "LINK_LIMIT_EXCEEDED", "description": "Link limit exceeded.", "detail": "Link limit exceeded." } | Link limit exceeded. |
| 400 | INVALID_PARTY | { "type": "INVALID_PARTY", "description": "Input parameters don't match each other.", "detail": "only parties with a first and last name can link their bank account" } | Input parameters don't match each other |
| 500 | ACCOUNT_ALREADY_LINKED | {"type": "ACCOUNT_ALREADY_LINKED","description": "Data provided was invalid for operation","detail": "The account ref has already been linked"} | The consumer has already a pending or linked bank account |
| 400 | ACCOUNT_ALREADY_LINKED | {"type": "ACCOUNT_ALREADY_LINKED","description": "Data provided was invalid for operation","detail": "The account ref has already been linked"} | The consumer has already a pending or linked bank account |
| 403 | BANK_ACCOUNT_LINKED_ON_MULTIPLE_PARTIES | {"type": "BANK_ACCOUNT_LINKED_ON_MULTIPLE_PARTIES","description": "Linked bank account associated with more than allowed number of party accounts.","detail": "Linked bank account associated with more than allowed number of party accounts."} | Linked bank account associated with more than allowed number of party accounts. |
| 403 | BANK_ACCOUNT_LINKING_DECLINED | {"type": "BANK_ACCOUNT_LINKING_DECLINED","description": "Unable to link this bank account.","detail": "BANK_ACCOUNT_LINKING_DECLINED"} | Unable to link this bank account, bank account on deny list |
| 400 | UNSUPPORTED_CURRENCY | {"type": "UNSUPPORTED_CURRENCY","description": "Input parameters don't match each other.","detail": "Only USD bank accounts supported"} | Non-USD currency, only USD accounts supported |
| 403 | RISKY_EVENT_DECLINED", | { "type": "RISKY_EVENT_DECLINED", "description": "Forbidden.", "detail": "Unable to process the link bank account request." } | The event was determined risky and declined |
| 403 | PARTY_SUSPENDED | { "type": "PARTY_SUSPENDED", "description": "Suspended", "detail": "Party Suspended" } | The consumer account is suspended |
| 409 | IDEMPOTENCY_KEY_IN_USE | { "type": "IDEMPOTENCY_KEY_IN_USE", "description": "idempotency_key was already used in another request", "detail": "IDEMPOTENCY_KEY_IN_USE" } | Idempotency key was used previously |
| 403 | INVALID_PARTNER_STATUS | {"type": "INVALID_PARTNER_STATUS","description": "fobidden","details": "PARTNER_INVAID"} | Invalid access |
| 409 | PARTY_MISMATCH | {"type": "PARTY_MISMATCH","description": "Providing user info don't match with existed party.","detail": "Providing user info doesn't match with email or tax id."} | Given user info does not match |
| 400 | VALIDATION_ERROR | {"type": "VALIDATION_ERROR","description": "Data provided was invalid for operation.","detail": "INVALID_PARTNER_ID"} | Invalid PartnerId |
| 500 | REMOTE_EXCEPTION | {"type": "REMOTE_EXCEPTION","description": "Internal error occurred.","detail": "Risk returned no config."} | Internal error performing risk check |
| 500 | REMOTE_EXCEPTION | {"type": "REMOTE_EXCEPTION","description": "Internal error occurred.","detail": "Risk returned no required partner party level."} | Internal error performing risk check |
| 400 | VALIDATION_ERROR | {"type": "VALIDATION_ERROR","description": "Request parameters didn't pass their validation, see errordetails.","detail": "Party already closed."} | Internal error suspending party after KYC failure. Consumer account already closed. |
| 400 | DATA_MISMATCH | {"type": "DATA_MISMATCH","description": "Input parameters don't match each other.","detail": "party already suspended"} | Internal error suspending party after KYC failure. Consumer already suspended |
| 500 | API_ERROR | { "type": "API_ERROR", "description": "Intenal error occurred.", "detail": "AGP api failed" } | Internal error suspending party after KYC failure. API failed |
| 500 | RPC_FAILED | { "type": "RPC_FAILED", "description": "Internal error occurred.", "detail": "failed to retrieve party to delete a party role" } | Internal error suspending party after KYC failure |
| 500 | RPC_FAILED | { "type": "RPC_FAILED", "description": "Internal error occurred.", "detail": "failed to delete a party" } | Internal error suspending party after KYC failure. Failed to rerieve party |
| 500 | RPC_FAILED | { "type": "RPC_FAILED", "description": "Internal error occurred.", "detail": "failed to retrieve party to add a party role" } | Internal error suspending party after KYC failure |
| 500 | RPC_FAILED | { "type": "RPC_FAILED", "description": "Internal error occurred.", "detail": "failed to add a party role" } | Internal error suspending party after KYC failure |
| 400 | FORBIDDEN_ACCOUNT | { "type": "FORBIDDEN_ACCOUNT", "description": "Existing account is suspended or blocked", "detail": "Party is suspended or blocked" } | Party is suspended |
| 500 | FORBIDDEN_ACCOUNT | { "type": "FORBIDDEN_ACCOUNT", "description": "Existing account is suspended or blocked", "detail": "Party is liquidated" } | Party is liquidated |
Bakkt Link URL Error Codes
| Reason Code | Error Explanation |
|---|---|
| link_expired | The embedded Link url has expired |
| session_expired | User session within the link has expired |
| bank_not_supported | Bank is not supported at Bakkt |
| user_cancelled | User cancelled bank linking process |
| plaid_bank_link_failure | The bank linking experience failed on Plaid |
| bakkt_bank_link_failure | Bank linking failed on Bakkt. This could happen for different reasons |
- User is Suspended
- Risk check at Bakkt failed
- Identity or Auth check at Plaid failed
- Bank account linking velocity limit reached at Bakkt
Updated 9 months ago