> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reembolsar un Payin

Este endpoint te permite reembolsar íntegramente una transacción de Payin previamente autorizada.

**Requisitos de reembolso**:

* El importe del reembolso debe coincidir con el importe original del pago.
* El reembolso debe enviarse al mismo beneficiario y a la misma cuenta utilizada para el pago original.


## OpenAPI

````yaml openapi/es/localpayment.json PATCH /api/payin/{externalId}/refund
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/payin/{externalId}/refund:
    patch:
      summary: Reembolsar un Payin
      operationId: refund-a-payin
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token).
          required: true
          schema:
            type: string
        - name: externalId
          in: path
          description: >-
            ID generado de tu lado para la trazabilidad de las transacciones.
            Debe ser único y solo acepta caracteres alfanuméricos y guiones (por
            ejemplo, UUID4).
          required: true
          schema:
            type: string
            pattern: '[a-zA-Z0-9\- ]+'
            examples:
              - 53025bf4-4c87-4b4f-8fea-b47004440f37
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                externalId:
                  type: string
                  description: >-
                    Un identificador único generado por tu sistema para rastrear
                    la transacción (alfanumérico y con guiones). Recomendamos
                    usar UUID4 para garantizar su unicidad. Solo se requiere
                    para reembolsos en efectivo y con Pix (Brasil).
                beneficiary:
                  type: object
                  description: >-
                    Objeto que contiene información sobre el beneficiario del
                    reembolso.  **Obligatorio solo para reembolsos de Pix
                    (Brasil) y en efectivo.**
                  properties:
                    type:
                      type: string
                      enum:
                        - COMPANY
                        - INDIVIDUAL
                      description: >-
                        Tipo de beneficiario (por ejemplo, `INDIVIDUAL`,
                        `COMPANY`).
                    name:
                      type: string
                      description: >-
                        El nombre del beneficiario. Los caracteres permitidos
                        dependen del campo `type`: para `individual`, letras
                        (incluidos los caracteres acentuados), espacios y puntos
                        (`.`); para `company`, el mismo conjunto más dígitos,
                        guion bajo (`_`) y guion (`-`).
                      minLength: 2
                      maxLength: 255
                    lastname:
                      type: string
                      description: >-
                        El apellido del beneficiario. Obligatorio cuando `type`
                        es `individual` y se ignora cuando `type` es `company`.
                        Los caracteres permitidos dependen de `type`: para
                        `individual`, letras (incluidos los caracteres
                        acentuados), espacios y puntos (`.`); para `company`, el
                        mismo conjunto más dígitos, guion bajo (`_`) y guion
                        (`-`).
                      minLength: 2
                      maxLength: 255
                    document:
                      type: object
                      properties:
                        type:
                          type: string
                          description: >-
                            El tipo de [documento de
                            identidad](/es/reference/identity-document-types),
                            como el Número de Identidad Nacional, el Número de
                            la Seguridad Social o el Permiso de Conducir, según
                            el país de expedición.
                        id:
                          type: string
                          description: >-
                            Número de documento de identidad (generalmente un
                            número). Este debe ser un número válido según las
                            normas del tipo de documento específico.
                    bank:
                      type: object
                      description: Datos bancarios del beneficiario.
                      properties:
                        name:
                          type: string
                          description: Nombre del banco.
                        code:
                          type: string
                          description: 'Código bancario. '
                        account:
                          type: object
                          description: Datos de la cuenta bancaria del beneficiario.
                          properties:
                            type:
                              type: string
                              description: >-
                                Tipo de cuenta bancaria (por ejemplo, `C`,
                                `S`). 
                            number:
                              type: string
                              description: Número de cuenta bancaria.
                          required:
                            - type
                            - number
                        branch:
                          type: object
                          description: '**Solo Brasil.** '
                          properties:
                            code:
                              type: string
                              description: Código de sucursal (de 1 a 5 dígitos).
                            name:
                              type: string
                              description: 'Nombre de la sucursal. '
                      required:
                        - name
                        - code
                        - account
                  required:
                    - type
                    - name
                    - bank
                comment:
                  type: string
                  description: >-
                    Comentario o nota que proporcione información adicional
                    sobre la transacción de reembolso.
              required:
                - externalId
                - beneficiary
              x-examples:
                Example 1:
                  comment: Refund API VA
                  beneficiary:
                    type: Type
                    name: Name
                    lastname: LastName
                    document:
                      type: DocumentType
                      id: DocumentId
                    bank:
                      name: BankName
                      code: Code
                      account:
                        type: BankAccountType
                        number: AccountNumber
            examples:
              Pix (Brazil) Refund:
                value:
                  comment: Pix refund
                  beneficiary:
                    type: INDIVIDUAL
                    name: John
                    lastname: Doe
                    document:
                      type: DocumentType
                      id: DocumentId
                    bank:
                      name: BankName
                      code: Code
                      account:
                        type: BankAccountType
                        number: AccountNumber
              902 - The payin was refunded:
                value:
                  externalId: e9407459-1ecc-4e18-800b-4bbae006afe2
                  internalId: 3e90d58c-8d3a-4c75-916e-a6d0add4f3b3
                  status:
                    code: '902'
                    description: REFUNDED
                    detail: The payin was refunded
              Cash refund:
                value:
                  comment: Cash refund
                  beneficiary:
                    type: INDIVIDUAL
                    name: John
                    lastname: Doe
                    document:
                      type: DocumentType
                      id: DocumentId
                    bank:
                      name: BankName
                      code: Code
                      account:
                        type: BankAccountType
                        number: AccountNumber
              Capture refund:
                value:
                  comment: Credit Card refund
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  externalId:
                    type: string
                    description: >-
                      Un identificador único generado por tu sistema para
                      rastrear la transacción (alfanumérico y con guiones).
                      Recomendamos usar UUID4 para garantizar su unicidad.
                  internalId:
                    type: string
                    description: Identificador de transacción de Localpayment.
                  status:
                    type: object
                    title: status
                    description: Estado de la operación.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          estado](/es/reference/transaction-status-error-codes).
                        examples:
                          - '902'
                      description:
                        type: string
                        description: >-
                          [Descripción del
                          estado](/es/reference/transaction-status-error-codes).
                        examples:
                          - REFUNDED
                      detail:
                        type: string
                        description: Información de estado adicional.
                        examples:
                          - The payin was refunded
                x-examples:
                  Example 1:
                    externalId: '{{ExternalId}}'
                    internalId: '{{InternalId}}'
                    status:
                      code: '902'
                      description: REFUNDED
                      detail: The payin was refunded
              examples:
                902 - The payin was refunded.:
                  value:
                    externalId: e36ef929-c2d4-fcf0-b30c-99dc51798f4b
                    internalId: c09095fb-6a0e-47af-9f43-3d9452b0f290
                    status:
                      code: '902'
                      description: REFUNDED
                      detail: The payin was refunded
        '400':
          description: Solicitud incorrecta
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: object
                    description: Estado de la operación.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          estado](/es/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: Descripción del estado.
                      detail:
                        type: string
                        description: Información de estado adicional.
                x-examples:
                  Example 1:
                    status:
                      code: '400'
                      description: ERROR
                      detail: Invalid operation
              examples:
                400 - Invalid operation:
                  value:
                    status:
                      code: '400'
                      description: ERROR
                      detail: Invalid operation
        '401':
          description: No autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Información adicional sobre la respuesta.
                  code:
                    type: string
                    description: Código de estado.
                  messages:
                    type: array
                    description: Lista de mensajes.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Clase de token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensaje con información adicional.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
        '404':
          description: No encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: object
                    title: status
                    description: Estado de la operación.
                    properties:
                      code:
                        type: string
                        description: >-
                          [Código de
                          estado](/es/reference/transaction-status-error-codes).
                      description:
                        type: string
                        description: Descripción del estado.
                      detail:
                        type: string
                        description: Información de estado adicional.
                x-examples:
                  Example 1:
                    status:
                      code: '404'
                      description: ERROR
                      detail: Payin not found
              examples:
                404 - Payin not found.:
                  value:
                    status:
                      code: '404'
                      description: ERROR
                      detail: Payin not found
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.