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.codeWhat it meansWhat to do
0303beneficiary was not sent, or it is blank.Send a non-blank recipient name.
0303clabe was not sent.Send clabe.
0304amount was not sent.Send amount.
0304amount is not a decimal, or it is a string in scientific notation.Send a decimal string, such as "50.00".
0304amount is zero or negative.Send an amount greater than zero.
0304amount has more than 2 decimal places.Use at most 2 decimal places.
0304currency was not sent, or it is not mxn.Send currency mxn.
0304protocol was not sent, or it is not clabe, debitcard, or phonenum.Send one of those three values.
0304A 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.
0304contact_id is not a positive number.Send the numeric id returned when the account was created.
0317The debit card in clabe has fewer than 16 digits.Send a 16-digit card number.
0317The phone number in clabe is not numeric.Send digits only.
0318numeric_ref is not 1 to 7 digits.Send 1 to 7 digits, or omit it and let the service assign one.
0319notes_ref is longer than 40 characters.Shorten it to 40 characters or omit it.
0356origin_id was already used.Use a new origin_id. The same value does not return the original withdrawal.
0381contact_id does not match a saved contact of the account.Use an id from the contacts list, or specify the receiver account instead.
0501amount exceeds the daily or monthly withdrawal limit of the account.Send a smaller amount, or increase the account limit.
0714The 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.
0714The CLABE is an Nvio CLABE. It starts with 710.An Nvio CLABE cannot be sent on SPEI. Use Nvio CLABE Bitso Transfer®.

Did this page help you?