The client's saved Pago MĂłvil account, where refunds are sent. The client manages
their own (one account each); an admin can also register and edit it from the
customer screen. Paths are relative to the /api/v1 prefix.
Requires a client bearer token (see Auth).
See Common errors.
| Method | URI | Access | Description |
|---|---|---|---|
GET |
/me/bank-account |
Client | The caller's saved Pago MĂłvil account |
POST |
/me/bank-account |
Client | Create or replace the caller's account |
DELETE |
/me/bank-account |
Client | Remove the caller's account |
Response 200
{
"account": {
"id_number": "V12345678",
"phone": "04125551234",
"bank_code": "0102",
"updated_at": "2026-09-15T14:00:00+00:00"
}
}
account is null when nothing has been saved.
| Field | Type | Description |
|---|---|---|
account |
object|null | null when the client has no saved account |
account.id_number |
string | Beneficiary cédula |
account.phone |
string | Beneficiary mobile |
account.bank_code |
string | 4-digit bank code |
Errors
| Status | When |
|---|---|
401 |
Missing or invalid client bearer token |
Creates the caller's account, or replaces it if one exists (one account per client).
Request body
| Field | Type | Required | Rules |
|---|---|---|---|
idNumber |
string | yes | CĂ©dula, regex ^[VEJGP]?\d{6,10}$; normalized to uppercase without separators |
phone |
string | yes | Venezuelan mobile, regex `^(0 |
bankCode |
string | yes | Exactly 4 digits |
Response 200 — { "account": {…} }, shaped like the GET above.
Errors
| Status | When |
|---|---|
401 |
Missing or invalid client bearer token |
422 |
Validation failed |
Removes the caller's account, if any.
Response 204 — no content.
Errors
| Status | When |
|---|---|
401 |
Missing or invalid client bearer token |