> For the complete documentation index, see [llms.txt](https://docs.pagsmile.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagsmile.com/reference/payout/retrieve-qrcode-data/peru.md).

# Peru

## Retrieve recipient data from QRCODE

<mark style="color:green;">`POST`</mark> `https://sandbox.transfersmile.com/api/payout/bank-account-list`

This endpoint allows you to retrieve the recipient's data from QRCODE.

#### Headers

| Name                                            | Type   | Description                                                 |
| ----------------------------------------------- | ------ | ----------------------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>  | string | application/json; charset=UTF-8                             |
| AppId<mark style="color:red;">\*</mark>         | string | Get AppId from dashboard                                    |
| Authorization<mark style="color:red;">\*</mark> | string | signature, generated by SHA256($sorted\_params + $app\_key) |

#### Request Body

| Name                                            | Type    | Description                                  |
| ----------------------------------------------- | ------- | -------------------------------------------- |
| country<mark style="color:red;">\*</mark>       | string  | <p>Country Code.</p><p>- PER</p>             |
| method<mark style="color:red;">\*</mark>        | string  | <p>Method<br>- Fixed value: QRCODE -</p>     |
| account\_type<mark style="color:red;">\*</mark> | string  | <p>Account type<br>- Fixed value: QRCODE</p> |
| account<mark style="color:red;">\*</mark>       | string  | Beneficiary's QRCode                         |
| timestamp<mark style="color:red;">\*</mark>     | Integer | unix timestamp, e.g. 1628512575              |
| buyer\_id                                       | string  | merchant user's id                           |
| email                                           | string  | <p>User's email<br>- Max. 200 chars -</p>    |

{% tabs %}
{% tab title="200 success " %}

```
{
    "code": 200,
    "msg": "success",
    "time": 1781496309,
    "data": [
        {
            "name": "LI*** EL*** QU*** PA***",
            "document_id": "47****35",
            "document_type": "DNI",
            "bank_code": "",
            "bank_name": "YAPE",
            "bank_number": "",
            "account": "00********18",
            "account_type": "",
            "amount": "",
            "scan_id": "QH2026********",
            "qrcode_type": "STATIC"
        }
    ]
}


```

{% endtab %}

{% tab title="500 system error" %}

```
{
    "code": 500,
    "msg": "system error",
    "time": 1628497751,
    "data": {
        "error": "system error"
    }
}
```

{% endtab %}
{% endtabs %}

## Example

```
curl --location --request POST 'https://sandbox.transfersmile.com/api/payout/bank-account-list' \
--header 'AppId: 94FAC**********************68548' \
--header 'Authorization: d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302' \
--header 'Content-Type: application/json' \
--data-raw '{
  "account": "0002015802PE26560032a5148da7d6f04b7e8e96c91bdbc85cb30116Plin****",
  "account_type": "QRCODE",
  "timestamp": "1780640823",
  "method": "QRCODE",
  "country": "PER",
  "buyer_id": "********",
  "email": "test@test.com"
}'
```

{% hint style="info" %}
Note: ***94FAC\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*68548*** is pagsmile's test merchant id for sandbox, and ***d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302*** is authorization token associated with the test App ID.
{% endhint %}

### Sandbox QR Code Test Data

Use the following sandbox QR codes to test the Retrieve QRCode Data API in Peru.

#### Static QR Code

```
0002015802PE26560032aoo88887d6f04b7e8e96cPlin Network P2P02033555534412P2P Transfer6666Lima69999999P***PERU_STATIC
```

**Response Sample**

```json
{
  "code": 200,
  "msg": "success",
  "time": 1784010668,
  "data": [
    {
      "name": "Test User Name",
      "document_id": "10********82",
      "document_type": "DNI",
      "bank_code": "",
      "bank_name": "BANCO GENIAL PERU",
      "bank_number": "",
      "account": "92********00",
      "account_type": "",
      "amount": "",
      "scan_id": "QH2026********",
      "qrcode_type": "STATIC"
    }
  ]
}
```

#### Dynamic QR Code

```
0002015802PE26560032aoo88887d6f04b7e8e96cPlin Network P2P02033555534412P2P Transfer6666Lima69999999P***PERU_DYNAMIC
```

**Response Sample**

```json
{
  "code": 200,
  "msg": "success",
  "time": 1784010679,
  "data": [
    {
      "name": "Test User Name",
      "document_id": "10********82",
      "document_type": "DNI",
      "bank_code": "",
      "bank_name": "BA********RU",
      "bank_number": "",
      "account": "92********00",
      "account_type": "",
      "amount": "10",
      "scan_id": "QH2026********",
      "qrcode_type": "DYNAMIC_INSTANT_PAYMENT"
    }
  ]
}
```

#### Invalid QR Code

```
0002015802PE26560032aoo88887d6f04b7e8e96cPlin Network P2P02033555534412P2P Transfer6666Lima69999999P***PERU_INVALID
```

**Response Sample**

```json
{
  "code": 400,
  "msg": "Invalid QR Code",
  "time": 1784010692,
  "data": {}
}
```

***
