Turn a CLABE On or Off

The PUT /spei/v1/clabes/{clabe}/status method lets you turn any unblocked CLABE you created on or off.

When you turn off a CLABE, it can no longer receive deposits. If a user deposits funds into it, the service rejects the transaction and initiates a refund of the sent funds to the sender's account applying a rejected deposit fee.

Mexican users can update the status of the CLABEs of type Additional in their account and non-Mexican users of type Additional International.

You cannot turn on or off the CLABE assigned by default when you create your account or enable International Payments in MXN, types Main and International, respectively.

In addition, Bitso operators can block a CLABE for security reasons or lack of payment for the service. You cannot change the status of a blocked CLABE.

To update the status of a CLABE that complies with the requirements outlined above, make the following HTTP request with the indicated parameters:

PUT ​​https://stage.bitso.com/spei/v1/clabes/{clabe}/status

Path Parameter

• clabe: The 18-digit CLABE whose status you want to update.

Body Parameters

• status: The state to which you want to switch the provided CLABE. Valid values: ENABLED and DISABLED.

The request object shown below exemplifies the body parameter used:

{  
    "status" : "DISABLED"  
}

A successful CLABE status update returns the following JSON object:

{  
    "success": true,  
    "payload": {  
        "clabe": "710969000000764616",  
        "type": "ADDITIONAL",  
        "status": "DISABLED",  
        "created_at": "2023-09-04T16:15:57",  
        "updated_at": "2023-09-05T23:04:05"  
    }  
}