Failed field validations
Field checks that reject an MXN create call before the withdrawal is created.
A create call that rejects a field returns HTTP 400:
{ "success": false, "error": { "message": "ERROR_MESSAGE", "code": "ERROR_CODE" } }These codes are for fields sent in the request. They are not a bank rejection. A bank rejection is a created withdrawal with status: failed and details.fail_reason. See Failed withdrawals.
error.code | What it means | What to do |
|---|---|---|
0303 | beneficiary was not sent, or it is blank. | Send a non-blank recipient name. |
0303 | clabe was not sent. | Send clabe. |
0304 | amount was not sent. | Send amount. |
0304 | amount is not a decimal, or it is a string in scientific notation. | Send a decimal string, such as "50.00". |
0304 | amount is zero or negative. | Send an amount greater than zero. |
0304 | amount has more than 2 decimal places. | Use at most 2 decimal places. |
0304 | currency was not sent, or it is not mxn. | Send currency mxn. |
0304 | protocol was not sent, or it is not clabe, debitcard, or phonenum. | Send one of those three values. |
0304 | A debit-card or phone withdrawal did not include institution_code, or institution_code is not numeric. message does not name the field. | Send the numeric institution_code of the bank that holds the account. |
0304 | contact_id is not a positive number. | Send the numeric id returned when the account was created. |
0317 | The debit card in clabe has fewer than 16 digits. | Send a 16-digit card number. |
0317 | The phone number in clabe is not numeric. | Send digits only. |
0318 | numeric_ref is not 1 to 7 digits. | Send 1 to 7 digits, or omit it and let the service assign one. |
0319 | notes_ref is longer than 40 characters. | Shorten it to 40 characters or omit it. |
0356 | origin_id was already used. | Use a new origin_id. The same value does not return the original withdrawal. |
0381 | contact_id does not match a saved contact of the account. | Use an id from the contacts list, or specify the receiver account instead. |
0501 | amount exceeds the daily or monthly withdrawal limit of the account. | Send a smaller amount, or increase the account limit. |
0714 | The CLABE is not 18 digits, or the checksum is wrong. A debit card in clabe with more than 16 digits also returns this code. | Send a valid 18-digit CLABE, or a 16-digit card number. Bitso does not check that the account exists. |
0714 | The CLABE is an Nvio CLABE. It starts with 710. | An Nvio CLABE cannot be sent on SPEI. Use Nvio CLABE Bitso Transfer®. |
Updated 1 day ago
Did this page help you?
