Specifying the receiver account

Create an MXN withdrawal by specifying the receiver account in the request.

Call Create a withdrawal. Send currency and protocol plus the account fields. Use this when the receiver account is not a saved contact.

Field checks are in Failed field validations.

🚧

Nvio CLABEs are not sent on SPEI

A CLABE that starts with 710 belongs to Nvio. An Nvio CLABE cannot be sent on SPEI. Use Nvio CLABE Bitso Transfer®. A SPEI withdrawal to it is rejected with error 0714.

Body Parameters

  • amount: The amount to be withdrawn in MXN. This value should be a positive number representing the monetary amount to be deducted from the Bitso account.
  • beneficiary: The recipient of the withdrawn funds.
  • clabe: The receiving account identifier. In the case of the Debit Card method, it stores the card number, and in the case of the Phone Number, it holds the mobile phone number. Bitso validates only the format, not that the account exists.
  • contact_id: Send it instead of the account fields. See Use a saved contact.
  • currency: The currency to withdraw using the available balance. Valid value: mxn.
  • institution_code: The identifier of the bank that holds the receiving account.
  • notes_ref: An alpha-numeric description of the withdrawal, maximum length 40 characters.
  • numeric_ref: The withdrawal's numeric reference is an identification number the sender provides that is useful to filter transactions—for example, a date. It has a maximum length of seven digits.
  • origin_id: A client-generated unique value that the server uses to recognize subsequent retries of the same request. This idempotency key helps prevent duplicated withdrawals from being processed. Valid character set: a to z (lower and uppercase), 0 to 9, underscore, _, and dash, -. Maximum length = 40 characters, so a UUID is a valid value. Formerly, this field was called client_withdrawal_id, a name now deprecated and must not be used.
  • protocol: A specific mechanism, protocol, or standard used in a network. Valid values: clabe, debitcard, and phonenum.
  • rfc: The beneficiary's taxpayer identification number (Registro Federal de Causantes).

Required and optional fields for each method are in Create a withdrawal. Send currency and protocol on every request.

Withdrawal Requests Providing the Account's Data

The following objects exemplify the body parameters included in the HTTP request when the receiver account is not a saved contact:

{
  "currency":"mxn",
  "protocol":"clabe",
  "amount":"50",
  "numeric_ref":"1234567",
  "notes_ref":"Pago servicios",
  "rfc":"PESJ590317IG4",
  "clabe":"646180110400000007",
  "beneficiary":"Juan Pérez",
  "origin_id":"bitso_c661dcdbf9e2" 
}
{
   "currency":"mxn",
   "protocol":"debitcard",
   "amount":"50",
   "numeric_ref":"5678123",
   "notes_ref":"Pago de servicios",
   "rfc":"PESJ590317IG4",
   "institution_code":"40002",
   "clabe":"5482347403740547",
   "beneficiary":"Juan Pérez",
   "origin_id":"bitso_0261817e9fc0" 
}
{
   "currency":"mxn",  
   "protocol":"phonenum",
   "amount":"50",
   "numeric_ref":"7890123",
   "notes_ref":"Pago servicios",
   "rfc":"PEST790317IG4",
   "institution_code":"40106",
   "beneficiary":"Tolentino Pérez",
   "clabe":"8180833954",
   "origin_id":"bitso_ae827fd4d571"
}

Did this page help you?