---
title: "Criar recebimento"
method: POST
path: "/payins"
tags: ["Recebimento"]
---

# Criar recebimento

`POST /payins`

## Request

- Base URL: `https://api.transfeera.com`
- URL: `https://api.transfeera.com/payins`
- Auth: HTTP bearer

## Headers

- `User-Agent` string

## Request body

- Payin
  - `id` string, uuid, required
  - `amount` integer, required
  - `payment_method` 'credit_card', required
  - `status` 'pending' | 'received' | 'canceled' | 'refunding' | 'refunded' | 'partially_refunded' | 'authorized' | 'unauthorized', required
  - `payment_method_details` object
    - `credit_card` object
      - `number` string, required
      - `expiration_month` integer, required
      - `expiration_year` integer, required
      - `security_code` integer, required
      - `holder_name` string, required
      - `installments` integer, required
      - `antifraud_fingerprint_id` string, required: Saiba mais [aqui](https://docs.transfeera.dev/reference/implementa%C3%A7%C3%A3o-do-antifraude).
      - `transaction_id` string, uuid, required
      - `rejection_reason` 'unauthorized_by_payer_institution' | 'amount_invalid' | 'installments_invalid' | 'card_expired' | 'card_invalid' | 'card_lost' | 'card_stolen' | 'card_pin_invalid' | 'card_pin_required' | 'card_security_code_invalid' | 'payer_institution_not_available' | 'payer_institution_transaction_error' | 'payer_balance_insufficient' | 'payer_limit_exceeded' | 'payer_account_not_found' | 'processor_transaction_error' | 'processor_transaction_timeout' | 'suspected_of_fraud' | 'merchant_registration_divergent' | 'unauthorized_by_payer_institution' | 'card_blocked' | 'unknown'
      - `payer` object, required
        - `name` string, required
        - `tax_id` string, required
        - `email` string, required
        - `phone` string, required
        - `address` ChargeAddress, required: Endereço
          - `street` string, required: Logradouro
          - `number` string, required: Número
          - `complement` string: Complemento
          - `district` string, required: Bairro
          - `city` string, required: Cidade
          - `state` string, required: UF
          - `postal_code` string, required: CEP
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Response `200`

OK

- Payin
  - `id` string, uuid, required
  - `amount` integer, required
  - `payment_method` 'credit_card', required
  - `status` 'pending' | 'received' | 'canceled' | 'refunding' | 'refunded' | 'partially_refunded' | 'authorized' | 'unauthorized', required
  - `payment_method_details` object
    - `credit_card` object
      - `number` string, required
      - `expiration_month` integer, required
      - `expiration_year` integer, required
      - `security_code` integer, required
      - `holder_name` string, required
      - `installments` integer, required
      - `antifraud_fingerprint_id` string, required: Saiba mais [aqui](https://docs.transfeera.dev/reference/implementa%C3%A7%C3%A3o-do-antifraude).
      - `transaction_id` string, uuid, required
      - `rejection_reason` 'unauthorized_by_payer_institution' | 'amount_invalid' | 'installments_invalid' | 'card_expired' | 'card_invalid' | 'card_lost' | 'card_stolen' | 'card_pin_invalid' | 'card_pin_required' | 'card_security_code_invalid' | 'payer_institution_not_available' | 'payer_institution_transaction_error' | 'payer_balance_insufficient' | 'payer_limit_exceeded' | 'payer_account_not_found' | 'processor_transaction_error' | 'processor_transaction_timeout' | 'suspected_of_fraud' | 'merchant_registration_divergent' | 'unauthorized_by_payer_institution' | 'card_blocked' | 'unknown'
      - `payer` object, required
        - `name` string, required
        - `tax_id` string, required
        - `email` string, required
        - `phone` string, required
        - `address` ChargeAddress, required: Endereço
          - `street` string, required: Logradouro
          - `number` string, required: Número
          - `complement` string: Complemento
          - `district` string, required: Bairro
          - `city` string, required: Cidade
          - `state` string, required: UF
          - `postal_code` string, required: CEP
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/transfeera/apis/recebimentos.md) - [All operations](https://skmtc.dev/transfeera/apis/recebimentos/llms.txt) - [OpenAPI document](https://skmtc.dev/transfeera/apis/recebimentos/revisions/4dc648d67cb1?raw)