---
title: "Criar link de de Prova de Vida (KYC)"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/criar-link-recebedor"
---

> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md

# Criar link de de Prova de Vida (KYC)

`POST` `/recipients/{recipient_id}/kyc_link`

Operation ID: `criar-link-recebedor`

Rota para gerar o QR Code de acesso ao webapp.

## Path parameters

- `recipient_id` (string, required) - Código do recebedor.

## Responses

- `200` - 200
- `400` - 400
- `404` - 404

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Pagar.me v5 API (Legado)
  version: 5.0.0
servers:
  - url: https://api.stone.com.br/core/v5
paths:
  /recipients/{recipient_id}/kyc_link:
    post:
      summary: Criar link de de Prova de Vida (KYC)
      description: Rota para gerar o QR Code de acesso ao webapp.
      operationId: criar-link-recebedor
      parameters:
        - name: recipient_id
          in: path
          description: Código do recebedor.
          schema:
            type: string
          required: true
      responses:
        "200":
          description: "200"
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                        "url": "www.pagar.me/kyc/14214214215...",
                        "base64_qrcode": "PD56bWwgdVyc2lvb...pIi8+PC9zdmc+",
                        "expires_at": "2025-05-10T17:17:26Z"
                    }
              schema:
                type: object
                properties:
                  url:
                    type: string
                    example: www.pagar.me/kyc/14214214215...
                  base64_qrcode:
                    type: string
                    example: PD56bWwgdVyc2lvb...pIi8+PC9zdmc+
                  expires_at:
                    type: string
                    example: 2025-05-10T17:17:26Z
        "400":
          description: "400"
          content:
            application/json:
              examples:
                Result:
                  value: >-
                    {
                        "errors": [
                            {
                                "message": "Must be passed a parameter to Create QrCode."
                            }
                        ]
                    }
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        message:
                          type: string
                          example: Must be passed a parameter to Create QrCode.
        "404":
          description: "404"
          content:
            application/json:
              examples:
                Result:
                  value: >-
                    {
                        "errors": [
                            {
                                "message": "re_clsnosxwp000a019ts7a262ay doesn´t have any kyc with partially_denied status."
                            }
                        ]
                    }
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        message:
                          type: string
                          example: re_clsnosxwp000a019ts7a262ay doesn´t have any kyc with partially_denied
                            status.
      deprecated: false
      x-readme:
        code-samples:
          - language: curl
            code: >-
              curl --request POST \
                   --url https://api.stone.com.br/core/v5/recipients/re_clsnosxwp000a019ts7a262ay/kyc_link \
                   --header 'accept: application/json' \
                   --header 'content-type: application/json'
        samples-languages:
          - curl
security:
  - sec0: []
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
```