Wires API Error Messages

 

VALIDATION_ERROR 

The request payload is validated for data integrity.  These are captured as part of validation errors. 

Instance Location Message Description
processing_date "message":"Must be today's date. Wires are only accepted for today's date." SVB process only current date wires payment and does not allow future dated payments
debit_account "message":"This account has not been authorized for debit" The debit account must be a registered account. Please either use a registered debit account or update the account number via update registration
beneficiary_address.address_line, beneficiary_bank.bank_addressaddress_line, intermediary_bank.bank_address.address_line "message":"Address Line item can be max 70 char and min 1 char" Address must be 1 to 70 characters maximum for wires payment
beneficiary_details.beneficiary_account "message":"IBAN is required for Country {0}" If WIRE type is INT or FX then based on the beneficiary country user must provide a valid IBAN number. It is mandatory user provides IBAN for some of the countries
beneficary_bank.local_routing_code "message":"local_routing_code is required" If WIRE type is INT or FX then based on the beneficiary country user must provide a valid local routing code. It is mandatory user provides local routing code for some of the countries
payment_details.purpose_of_payment_code "message":"Invalid purpose_of_payment_code. List of acceptable codes {0}" If WIRE type is INT or FX then based on the beneficiary country code user must provide a valid purpose of payment code. Please provide a valid purpose of payment code for the associated beneficiary country.
intermediary_bank "message":"intermediary_bank details are required" Intermediary Bank Details is mandatory xx
beneficiary_address.country, beneficiary_bank.bank_address.country, intermediary_bank.bank_address.country "message":"post_code, town_name And state are mandatory for the Country {0}" If Country is US or CA then the following fields are mandatory; post_code, town_name and state
deal.id "message":"deal_id is required for FX payment" If WIRE Type = FX then user must provide deal_id to process the payment. Please submit a valid deal_id
deal.id "message":"The deal_id sent in the wire request is cancelled and is no longer available for sending wires." If WIRE Type = FX then user must provide a valid deal_id to process the payment. Please provide a deal_id which is in "Active" status
deal.id "message":"The deal_id sent in the wire request can not be settled at this time for sending wires." If WIRE Type = FX then user must provide a valid deal_id to process the payment. Please provide a deal_id which is in "Active" status
debit_account "message":"Debit account for wire must be same as debit account used for the fx trade." If WIRE Type =FX then user must provide the debit account that was used in creating the deal_id
amount.value "message":"Amount for wire must be same as the buy amount in fx trade." If WIRE Type =FX then user must provide the transaction amount same as the one used in creating the deal_id. At present SVB does not support splitting the deal.
amount.currency_code "message":"Currency for wire must be same as currency bought in the fx trade." If WIRE Type =FX then user must provide the currency code same as the one used in creating the deal_id.
amount.value "message":"Invalid value provided" Transaction Amount Value is not valid.
amount.currency_code "message":"Only USD Fed wires are supported." If Wires Type = US then user must provide a valid fed enabled Beneficiary Bank Routing Number to process a US wire payment.
amount.currency_code "message":"Invalid currency_code for FX Payments" If Wires Type = FX then user must provide a valid allowed SVB Foreign Currency. Please refer to Gateway list of allowed FX currency for reference
amount.value "message":Amount must be greater than zero." Transaction Amount Value must be greater than zero to process a payment

 

ENTITLEMENT_ERROR

The request payload is checked for entitlements that a customer has onboarded with such as debit_account and transactional limits etc Those errors will be captured here.

Instance Location Message Description
amount.value "message":"Daily Limit is exceeded" Transaction amount must be within the allowed limit set for the payment type at the time of registration.
amount.value "message":"Transaction Limit is exceeded" Transaction amount must be within the allowed limit set for the payment type at the time of registration.

 

ACCOUNT_ERROR

The request payload is checked for any types of account related errors such as balance, status or hold etc. Those errors will be captured here.

Instance Location Message Description
amount.value "message":"The amount in debit account is not sufficient to make this payment, please check and try again" The account number provided does not have enough balance to process the payment. 
debit.account "Accounts Inquiry endpoint didn't return any response." Internal SVB endpoint is down. Please resubmit after sometime  
debit_account "message":"AccountId not found, please check the provided value and try again" Debit Account must be a valid SVB debit account
debit_account "message":"Invalid account status" Debit Account must be an 'Active' SVB debit account

 

BENEFICIARY_ERROR

The request payload is checked for beneficiary related errors such as beneficiary bank routing code, account etc, Those errors will be captured here.

Instance Location Message Description
beneficiary_bank.routing_number "message":"No matching bank branch address found for the routing number " User must provide a valid Beneficiary Bank Routing Number to process a wire payment.
beneficiary_bank.routing_number "message":"Invalid routing_number. Please check the Beneficiary Bank routing number" User must provide a valid Beneficiary Bank Routing Number to process a wire payment. If Wire Type is US then please provide the ABA number. IF Wires Type is INT or FX then please provide SWIFT/BIC
beneficiary_bank.routing_number "message":"Routing code is invalid" User must provide a valid Beneficiary Bank Routing Number to process a wire payment. If Wire Type is US then please provide the ABA number. IF Wires Type is INT or FX then please provide SWIFT/BIC

 

TRANSACTION_ERROR

The request payload is checked for transactional errors due to fraud etc. Those errors will be captured here.

Instance Location Message Description
processing_date "message":"You have submitted the transaction outside of the wire processing time e.g., after cutoff, weekend, holidays. Please resubmit the transaction during the wire processing time." If Wire Type is US or INT then date must be current business date & within cut-off. Cut off time for US & INT: 2:00 am to 2:30 pm PST