---
title: "Recipient Account"
method: POST
path: "/v1/payment/payment-key/info"
tags: ["Recipient Services Account"]
---

# Recipient Account

`POST /v1/payment/payment-key/info`

Service to obtain recipient account information.

## Request body

- RecipientAccount
  - `payment_key` string, required — Pix payment key. Options are CNPJ, CPF, telephone, email, or random payment key (max 100 characters)
  - `transaction` object, required
    - `reference_id` string, required — Transaction identifier, generated by client. (Maximum of 50 characters - Unique per transaction).
    - `business_id` string — Business ID. The ID of the transaction related with this payment
    - `account` string, required — Client account number provided by Koin
    - `amount` object, required
      - `currency_code` string, required — Currency code (ISO 4217)
      - `value` number, required — Payment total amount
    - `descriptor` string — Description sent to recipient of payment (Max. 140 characters)}

## Response `200`

Recipient response

- RecipientResponse
  - `id` string — Identifier search recipient.
  - `name` string — Full name.
  - `document` object
    - `type` 'cpf' | 'cnpj', required — Payer document type (cpf, cnpj)
    - `number` string, required — Payer document number
  - `account` object
    - `agency` string — Receiver account Agency.
    - `code` string — Receiver account number.
    - `type` string — Receiver account type.
  - `bank` object
    - `name` string — Bank.
    - `ispb` string — Brazilian Payment System Identifier (eight-number length).
  - `descriptor` string — Text send to client. Maximum of 140 characters.
  - `code` string — Standardized error code (applies only for error cases)
  - `message` string — Message associated with the error code (applies only for error cases)

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/koin/apis/payments-api.md) · [All operations](https://skmtc.dev/koin/apis/payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/koin/payments-api/revisions/6f2c01e43fe2/schema)