---
title: "Preview beneficiary transfer (supports PIX and other methods)"
method: POST
path: "/v0.2.4/beneficiary/preview"
tags: ["Beneficiary"]
---

# Preview beneficiary transfer (supports PIX and other methods)

`POST /v0.2.4/beneficiary/preview`

## Request body

- object
  - `method` string, required — Payment method
  - `country` string, required — Country code
  - `currency` string, required — Currency code
  - `pixKey` string — PIX key (required for PIX transfers)
  - `pixKeyType` 'CPF' | 'CNPJ' | 'PHONE' | 'EMAIL' | 'EVP' — Type of PIX key (optional for PIX)
  - `protocol` 'pix_ind' — Transfer protocol (for PIX)

## Response `200`

Transfer preview retrieved successfully

- object
  - `status` string
  - `message` string
  - `data` object — Preview data varies by payment method

## Other responses

- `400` — Validation error in the request.
- `401` — Access to this resource is not available for unauthenticated users.
- `500` — Indicates an internal server error.

---

[API](https://skmtc.net/chimoney/apis/chimoney-api-docs.md) · [All operations](https://skmtc.net/chimoney/apis/chimoney-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chimoney/chimoney-api-docs/revisions/227751df36a0/schema)