# Cards

## Detalla la asignación de una tarjeta a un cliente final, dentro de un lote de tarjetas de Odybank. La tarjeta luego de ser asignada su estado es INACTIVE.

<mark style="color:green;">`POST`</mark> `/api-hub/v1/client-cards/assign`

Las credenciales otorgadas para realizar el login obtienen el producto el cual se le asignará al cliente final.

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                                         | Type   | Description                                                                                                                    |
| -------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| client\_id<mark style="color:red;">\*</mark> | String | El identificador del cliente debe de ser en formato UUID.                                                                      |
| timestamp<mark style="color:red;">\*</mark>  | String | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

{% tabs %}
{% tab title="200: OK Detalle de tarjeta asignada" %}
**Definición del response**

**status**: El estado tiene que estar no activa, ya existe un endpoint que se encarga de activar la tarjeta de un cliente.

**card\_tracking\_code**: El código de seguimiento de la tarjeta, es generada desde Odybank.

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": {
		"id": "176fb137-9298-be03-42f6-a31c4faa3616",
		"status": "INACTIVE",
		"created_at": "2022-09-22T20:01:19.095306+00:00",
		"updated_at": "2022-09-22T20:01:21.587199+00:00",
		"deleted_at": null,
		"is_deleted": false,
		"is_deleted_by": null,
		"provider_name": "ODYBANK",
		"card_tracking_code": "0332206224610292",
		"merchant_product_id": "b349ee01-8d7d-6c51-ca3d-7b98deac14ac",
		"client_id": "6e28b4dc-a81c-6464-8534-ec489c221a58",
		"reason": null,
		"currencies": [
			{
				"account": "0332206224610316",
				"currency": "PEN"
			}
		],
		"blocked_at": null,
		"replacement_by": null,
		"card_pan":   "222980******0739"
	}
}
```

{% endtab %}
{% endtabs %}

## Detalla la activación de una tarjeta, el estado es modificado a ACTIVE.

<mark style="color:purple;">`PATCH`</mark> `/api-hub/v1/client-cards/activation`

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                                                   | Type   | Description                                                                                                                    |
| ------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String | El código de seguimiento de la tarjeta.                                                                                        |
| timestamp<mark style="color:red;">\*</mark>            | String | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

{% tabs %}
{% tab title="200: OK " %}
**status** : El estado ahora es activa.

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": {
		"id": "176fb137-9298-be03-42f6-a31c4faa3616",
		"status": "ACTIVE",
		"created_at": "2022-09-22T20:01:19.095306+00:00",
		"updated_at": "2022-09-22T20:01:21.587199+00:00",
		"deleted_at": null,
		"is_deleted": false,
		"is_deleted_by": null,
		"provider_name": "ODYBANK",
		"card_tracking_code": "0332206224610292",
		"merchant_product_id": "b349ee01-8d7d-6c51-ca3d-7b98deac14ac",
		"client_id": "6e28b4dc-a81c-6464-8534-ec489c221a58"
	}
}
```

{% endtab %}
{% endtabs %}

## Detalla la información de una tarjeta.

<mark style="color:blue;">`GET`</mark> `/api-hub/v1/client-cards/details`

#### Query Parameters

| Name                                                   | Type   | Description                                                                                                                    |
| ------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String | El código de seguimiento de la tarjeta.                                                                                        |
| key\_id<mark style="color:red;">\*</mark>              | UUID   | El identificador de la llave, para encriptar los datos.                                                                        |
| timestamp<mark style="color:red;">\*</mark>            | String | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

{% tabs %}
{% tab title="200: OK " %}
**Definición del response**

**date\_expiration**: La fecha de caducidad de la tarjeta, se encuentra encriptada por seguridad.

**number\_card**: El número de la tarjeta, se encuentra encriptada por seguridad.

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": {
		"card_tracking_code": "0332206224610292",
		"currency": {
			"number": "604",
			"string": "SOLES"
		},
		"date_block": "2022-09-28 20:21:09.16",
		"date_expiration": "P0QFz5bJEWzjvdea7IalCnvZ7gJd9BqDB+K/fyLgO1k67IcpnI5ErwU7Hf5wHSCgUdrVmKfMR781HnoCBrXl/y0bwaVhYuvpJBPf+0qaj2VHarSsyd0PVlxwXCn98/TAAKOJlGBhnu8XaKlQviYp8XccjtHJ4zWzwzbl71uWkiRuamN9GzxcC8+eWNBEBwVkovUO+1Qc/YVfEVlG/Lx3EBeZ6Q4okg0bp5QAQ5/XNGVSme5ItBIFbp5hBF0PNsuMsGEp5+GHO8Ka2mZVvUUOHabkGsA0l0M33FONKEZZH1SU8InzJ3Pa00q5SqjqpdJ9xkPATyVhIxiGPsjsrvunaLtzIGGkZNobOzwhsbvQjX77Wxeh+JFOrXxbJmOCpSgm4caFvrv9KExecypQDFxQSVG2/NM3oTtgnMCwDnD8WZe7eP79Y4OjUpu05utPXbJeImBB3iYRt6qUmTQi+eStVSkyF5e6bPx8jRpTEK0pPrS9N8ekjoHuizRDYjwhHItaxHZpHAnbIRqleyg1rroctgqHGTRUxjbe/CQeWaQ99f3DFgDx1LvhE1HZpYfY2iyb0vy0ThpfdB+5njyg4bw1l6NpjL+RJQxEaPuwPr8CGgjigsxmMpfb8GHE8jGWgFw8Tx+O8uNaFCK7ROUtNYhIpIL+9Liw7k1Uk8DXZE60p3E=",
		"number_card": "WlZlRE3yNmah3DSXA6eUozNp1vFEu9ROgX4RBcF3llYF+SChpDtXzoS05wC6aCQ3v1Pq1RbLM7xSwhoaQ5d4Ubihfc6NjBQbGbvs7gxgg+6y896A557cRdSE0l2wEs+oKzA3advpy45g+TEH4cY3SmCEkcFSC+F/+kWR3bs712PxgmzGSYFbwU/fDKyvo+FHwxW2dBM6j3xVwySVzDj2H26OlaKQTbIbnif7SoCu+sT7toQN2exxEZ9KWpcI8uiFed09a8OCO02auJWVZTOdoEFsg054y87LAaExEqAkeGSyA3ZMYUUXf8JbXbfzH0dhlT86POdccJ4eCMFHakzkm/hdh9UsGvhjnb/MKbI/Q7EW9XgPnGJa5EM5ttA7hV47mTg1ZSYFZtMmuplA6TC99cn7qO4MC6wsg+96IzH15WDGNR0Xp3FtWfOA5aNY7jLJvWhIoKRrD7foPnn6xCUafrdhttWbcfrIVOPh+bP+2rUG5Y1/kOWRmqgIEnLeh9g/mqBbJcr3NtvtdlaZNMgdhx4rtmRohD1gV53MgpkXaZma+dFrjmZvvat737NKlmVfZuGasox+L9Xz5hUQFwUYZ8tJK4DUMowA7ihrfdvwM3+1SSbjoj6ZKrUjFZEugAn6tx2dQlfkLnJffsXObWMITrC4RcCNmHcQLYr50n36h9s=",
		"reason_block": "CANCELACIÓN",
		"status": "CANCELED",
		"status_description": "CANCELED (CANCELADA)"
	}
}
```

{% endtab %}
{% endtabs %}

## Detalla el cvv2 de una tarjeta.

<mark style="color:blue;">`GET`</mark> `/api-hub/v1/client-cards/cvv2`

#### Query Parameters

| Name                                                   | Type   | Description                                                                                                                    |
| ------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String | El código de seguimiento de la tarjeta.                                                                                        |
| timestamp<mark style="color:red;">\*</mark>            | String | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |
| key\_id<mark style="color:red;">\*</mark>              | UUID   | El identificador de la llave, para encriptar los datos.                                                                        |

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

{% tabs %}
{% tab title="200: OK " %}
**Definición del response**

**cvv2**:  El código de seguridad de la tarjeta, se encuentra encriptada por seguridad.

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": {
		"cvv2": "OUD6apORicAur/cM0plT4skz/ICWWLerdlyx5x3Z3Ltc4jJYfaHOipDQdT/IF1eSySmzfSwMlQY7lgsDQmmU8ZnGN3HrLbBUlpqOJpSednbcSQ0yH6v3CN+LIHaVKDdJNejibJjbKpKm/ZCD9CP7OWe9gm4c5qM7mop4wtE0stb/kutx9PJtxTTp4VfiGA/lC6jTwmy9zGuewRc/phKN9T3uru68Hrv+kaPVbIaOw4jg2sskALszImU5fJhNH1Aaj+mCLJ5tUgK6GoUQ25FxIY0Rfy8HMxSrFHVb9c7PqvmkFs6PWu4N4V3r7wx5nocAJw7MBesHuWJxXmOX3TGVHQeCQBNlOkkgGphp9uau4057amHjc7GyKppoBOczNUAdbxvE88N2i7RitZR/gZDTdsnTkY+9q0nurkxkDad2WXVnpOquAV7MIspCc2MWXlNSWUO9UJ3laFLRSSnynUZC8Q6rMzJcobPIbemOgKyrzrVS2NNIQbtiTvxZVD0WmUGCbYCSWoIoq/B0c+qufuLjpjdvL/2w/QDKKasYm2WB55wrgLVGq2/CAI7jFSBHBgw/iTxVR0Dm35zuYdEYyjqUBWGkAtvQrrsf+KC9rCS5DQ79kUfxYA5OhO0tD3mlNI0LaN7edMz+jek6ybbfQHh8pLgXS0aGHF1LLons1rKO8Zo="
	}
}
```

{% endtab %}
{% endtabs %}

## Detalla la información de las transacciones de una tarjeta.

<mark style="color:blue;">`GET`</mark> `/api-hub/v1/client-cards/transactions`

#### Query Parameters

| Name                                                   | Type   | Description                                                                                                                    |
| ------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String | El código de seguimiento de la tarjeta.                                                                                        |
| timestamp<mark style="color:red;">\*</mark>            | String | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

{% tabs %}
{% tab title="200: OK " %}
Definición del response

**card\_tracking\_code** : El código de seguimiento de la tarjeta.

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": [{
		"sequence": "129877",
		"type": "Compra    ",
		"amount": "179.40",
		"cost": "0.00",
		"hour": "16:58:32",
		"date": "2022/10/07",
		"commerce": "PLAZA VEA              Lima          PER",
		"commerce_category": null,
		"pan_trunc": "22298003****0071",
		"currency": "PEN"
	}]
}
```

{% endtab %}
{% endtabs %}

## Detalla la suspensión de una tarjeta, el estado es modificado a SUSPENDED.

<mark style="color:purple;">`PATCH`</mark> `/api-hub/v1/client-cards/suspend`

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                 | Type       | Description                                                                                                                    |
| -------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code | String     | Código de seguimiento de una tarjeta                                                                                           |
| timestamp            | String     | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |
| reason               | String(50) | Razón de suspensión                                                                                                            |

{% tabs %}
{% tab title="200: OK " %}
**Definición del response**

**status** El estado ahora es SUSPENDED.

```javascript
{
	"code": "00000",
        "message": "Successful",
        "data": {
        "id": "176fb137-9298-be03-42f6-a31c4faa3616",
        "status": "SUSPENDED",
        "created_at": "2022-09-22T20:01:19.095306+00:00",
        "updated_at": "2022-09-28T17:07:47.926054+00:00",
        "deleted_at": null,
        "is_deleted": false,
        "is_deleted_by": null,
        "provider_name": "ODYBANK",
        "card_tracking_code": "0332206224610292",
        "merchant_product_id": "b349ee01-8d7d-6c51-ca3d-7b98deac14ac",
        "client_id": "6e28b4dc-a81c-6464-8534-ec489c221a58"
	}
}
```

{% endtab %}
{% endtabs %}

## Detalla la activación de una tarjeta, el estado es modificado a BLOCKED.

<mark style="color:purple;">`PATCH`</mark> `/api-hub/v1/client-cards/blocked`

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                                                   | Type   | Description                                                                                                                    |
| ------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String | Código de seguimiento de una tarjeta                                                                                           |
| reason<mark style="color:red;">\*</mark>               | String | Razón de bloqueo                                                                                                               |
| timestamp<mark style="color:red;">\*</mark>            | String | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

{% tabs %}
{% tab title="200: OK " %}
**Definición del response**

**status** El estado ahora es BLOCKED.

```javascript
{
	"code": "00000",
    "message": "Successful",
    "data": {
        "id": "176fb137-9298-be03-42f6-a31c4faa3616",
        "status": "BLOCKED",
        "created_at": "2022-09-22T20:01:19.095306+00:00",
        "updated_at": "2022-09-28T17:07:47.926054+00:00",
        "deleted_at": null,
        "is_deleted": false,
        "is_deleted_by": null,
        "provider_name": "ODYBANK",
        "card_tracking_code": "0332206224610292",
        "merchant_product_id": "b349ee01-8d7d-6c51-ca3d-7b98deac14ac",
        "client_id": "6e28b4dc-a81c-6464-8534-ec489c221a58"
	}
}
```

{% endtab %}
{% endtabs %}

## Detalla la cancelación de una tarjeta, el estado es modificado a CANCELED.

<mark style="color:purple;">`PATCH`</mark> `/api-hub/v1/client-cards/cancel`

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                                                   | Type       | Description                                                                                                                    |
| ------------------------------------------------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String     | El código de seguimiento de la tarjeta.                                                                                        |
| reason<mark style="color:red;">\*</mark>               | String(50) | Razón (motivo) de cancelar                                                                                                     |
| timestamp<mark style="color:red;">\*</mark>            | String     | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

{% tabs %}
{% tab title="200: OK " %}
**Definición del response**

**status** El estado ahora es CANCELED.

```javascript
{
    "code": "00000",
    "message": "Successful",
    "data": {
        "id": "176fb137-9298-be03-42f6-a31c4faa3616",
        "status": "CANCELED",
        "created_at": "2022-09-22T20:01:19.095306+00:00",
        "updated_at": "2022-09-30T20:50:26.851541+00:00",
        "deleted_at": null,
        "is_deleted": false,
        "is_deleted_by": null,
        "provider_name": "ODYBANK",
        "card_tracking_code": "0332206224610292",
        "merchant_product_id": "b349ee01-8d7d-6c51-ca3d-7b98deac14ac",
        "client_id": "6e28b4dc-a81c-6464-8534-ec489c221a58",
        "reason": "Cancelación de prueba"
    }
}
```

{% endtab %}
{% endtabs %}

## Detalla la recarga de saldo de una tarjeta.

<mark style="color:green;">`POST`</mark> `/api-hub/v1/client-cards/recharge-balance`

#### Headers

| Name                                                  | Type | Description                                                                                                                   |
| ----------------------------------------------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> |      | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           |      | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                                                   | Type                 | Description                                                                                                                    |
| ------------------------------------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String               | El código de seguimiento de la tarjeta.                                                                                        |
| currency<mark style="color:red;">\*</mark>             | String \[PEN \| USD] | ISO 4217. Actualmente solo hay para PEN y USD.                                                                                 |
| amount<mark style="color:red;">\*</mark>               | Decimal              | El monto debe ser un decimal por punto. Ejemplo: 20.50. Si no contiene decimal mandar solo el entero 20.                       |
| timestamp<mark style="color:red;">\*</mark>            | String               | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": {
		"transaction_id": "83fg7e0c-1b68-5t07-4ac9-b3106faf537a",
		"sequence": "1231444234"
	}
}
```

{% endtab %}
{% endtabs %}

## Detalla el debito de una tarjeta (cash out).

<mark style="color:green;">`POST`</mark> `/api-hub/v1/client-cards/cash-out-balance`

#### Headers

| Name                                            | Type   | Description                                                                                                                   |
| ----------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>     | String | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                                                   | Type                 | Description                                                                                                                    |
| ------------------------------------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String               | El código de seguimiento de la tarjeta.                                                                                        |
| currency<mark style="color:red;">\*</mark>             | String \[PEN \| USD] | ISO 4217. Actualmente solo hay para PEN y USD.                                                                                 |
| amount<mark style="color:red;">\*</mark>               | Decimal              | El monto debe ser un decimal por punto. Ejemplo: 20.50. Si no contiene decimal mandar solo el entero 20.                       |
| timestamp<mark style="color:red;">\*</mark>            | Number String        | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": {
		"transaction_id": "83ff7e0c-5b68-5c07-4ac9-b0106faf457a",
		"sequence": "123123237"
	}
}
```

{% endtab %}
{% endtabs %}

## Muestra el saldo de una tarjeta

<mark style="color:blue;">`GET`</mark> `/api-hub/v1/client-cards/balance`

#### Query Parameters

| Name                                                   | Type   | Description                                                                                                                    |
| ------------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code<mark style="color:red;">\*</mark> | String | El código de seguimiento de la tarjeta.                                                                                        |
| timestamp<mark style="color:red;">\*</mark>            | String | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           |        | La firma depende del timestamp y el secret-key.                                                                               |

{% tabs %}
{% tab title="200: OK " %}

**Definición del response**

**card\_tracking\_code** : El código de seguimiento de la tarjeta.

```javascript
{
    "code": "00000",
    "message": "Successful",
    "data": {
        "sequence": "000409",
        "currency": "PEN",
        "balance": "1812.10"
    }
}
```

{% endtab %}
{% endtabs %}

## Reposición de tarjeta (Bloqueada)

<mark style="color:green;">`POST`</mark> `/api-hub/v1/client-cards/replacement-card`

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                                                            | Type   | Description                                                                                                                    |
| --------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code\_blocked<mark style="color:red;">\*</mark> | String | El código de seguimiento de la tarjeta bloqueada.                                                                              |
| timestamp<mark style="color:red;">\*</mark>                     | String | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": {
		"id": "d336849b-e8ca-07fe-58b2-b10cbf0ce2b6",
		"status": "INACTIVE",
		"created_at": "2022-10-17T22:46:21.658455+00:00",
		"updated_at": "2022-10-17T22:46:21.658455+00:00",
		"deleted_at": null,
		"is_deleted": false,
		"is_deleted_by": null,
		"provider_name": "ODYBANK",
		"card_tracking_code": "0332206224610316",
		"merchant_product_id": "b349ee01-8d7d-6c51-ca3d-7b98deac14ac",
		"client_id": "6e28b4dc-a81c-6464-8534-ec489c221a58",
		"reason": null,
		"currencies": [
			{
				"account": "0332206224610316",
				"currency": "PEN"
			}
		],
		"blocked_at": null,
		"replacement_by": null,
		"card_pan":   "222980******0739"
	}
}
```

{% endtab %}
{% endtabs %}

## Transferencia de saldo tarjeta a tarjeta

<mark style="color:green;">`POST`</mark> `/api-hub/v1/client-cards/transfer-balance-card-to-card`

#### Headers

| Name                                                  | Type   | Description                                                                                                                   |
| ----------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| authorization-token<mark style="color:red;">\*</mark> | String | <p>Se envía el token generado luego del Login, se debe enviar con el siguiente formato:</p><p>"Bearer JHgytHG67687JHG..."</p> |
| signature<mark style="color:red;">\*</mark>           | String | La firma depende del timestamp y el secret-key.                                                                               |

#### Request Body

| Name                                                           | Type                 | Description                                                                                                                    |
| -------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| card\_tracking\_code\_target<mark style="color:red;">\*</mark> | String               | Código de seguimiento de la tarjeta de destino, a la cual se le abonara el monto                                               |
| card\_tracking\_code\_source<mark style="color:red;">\*</mark> | String               | Código de seguimiento de la tarjeta de origen, de la cual se debitará el monto                                                 |
| currency<mark style="color:red;">\*</mark>                     | String \[PEN \| USD] | ISO 4217. Actualmente solo hay para PEN y USD.                                                                                 |
| amount<mark style="color:red;">\*</mark>                       | Decimal              | El monto debe ser un decimal por punto. Ejemplo: 20.50. Si no contiene decimal mandar solo el entero 20.                       |
| timestamp<mark style="color:red;">\*</mark>                    | String               | El valor debe ser en formato NOW comprendido por 13 dígitos, en javascript se puede usar la función Date.now() = 1664568045547 |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
	"code": "00000",
	"message": "Successful",
	"data": {
		"transaction_id": "83ff7e0c-5b68-5c07-4ac9-b0106faf457a",
		"sequence": "123123237"
	}
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.globalbridgeconnections.com/reference/api-reference/cards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.