---
title: "POST payin.new"
method: POST
path: "payin.new"
---

# POST payin.new

`POST payin.new` (webhook)

## Payload

- PayinNewWebhookOut
  - `webhook_event` 'payin.new', required
  - `id` string, required
  - `status` 'processing' | 'on_hold' | 'failed' | 'refunded' | 'completed', required — Payin general status
  - `pix_code` string, nullable — PIX code
  - `memo_code` string, nullable — Memo code
  - `clabe` string, nullable — CLABE code
  - `partner_fee` integer — Payin partner fee amount in cents
  - `tracking_complete` object, required
    - `step` 'processing' | 'on_hold' | 'pending_review' | 'pending_refund_review' | 'completed', required — Complete step
    - `transaction_hash` string, nullable — Complete transaction hash
    - `completed_at` string, nullable — Complete completed date
  - `tracking_payment` object, required
    - `step` 'processing' | 'on_hold' | 'pending_review' | 'pending_refund_review' | 'completed', required — Payment step
    - `provider_name` string, nullable — Payment provider name
    - `completed_at` string, nullable — Payment completed date
    - `review_source` string, nullable — Primary risk source that sent this payin to manual review
    - `review_context` object, nullable — Structured risk context for manual review
    - `review_sources` string[], nullable — Every risk source that flagged this payin on the pending review
    - `review_contexts` object, nullable — Structured risk context per flagging source
    - `approved_risk_sources` string[], nullable — Risk sources already approved by an analyst
  - `tracking_transaction` object, required
    - `step` 'processing' | 'on_hold' | 'pending_review' | 'pending_refund_review' | 'completed', required — Payin transaction step
    - `status` 'failed' | 'completed', nullable — Payin transaction status
    - `external_id` string, nullable — Payin transaction external id
    - `completed_at` string, nullable — Payin transaction completed date
    - `transaction_hash` string, nullable — Blockchain transaction hash
    - `provider_name` 'Nvio Pagos' | 'Brex' | 'Stark Bank' | 'JPMorgan Chase' | 'HSBC' | 'Inter' | 'JP Morgan Chase' | 'Bitso' | 'Citi' | 'CFSB' | 'Triple A Technologies' | 'Portage Bank', nullable — Payment provider name
    - `provider_transaction_id` string, nullable — Payment provider transaction id
    - `sender_name` string, nullable
    - `sender_bank_name` string, nullable
    - `sender_tax_id` string, nullable
    - `sender_bank_code` string, nullable
    - `sender_account_number` string, nullable
    - `end_to_end_id` string, nullable — BACEN Pix end-to-end transaction ID (govt Pix ID)
    - `trace_number` string, nullable
    - `transaction_reference` string, nullable
    - `description` string, nullable
    - `pse_instruction` object, nullable
      - `payment_link` string, required — PSE payment link URL
      - `fid` string, required — PSE funding identifier for webhook matching
      - `full_name` string, required — PSE payer full name
      - `tax_id` string, required — PSE payer document number
      - `document_type` 'CC' | 'NIT', required — PSE payer document type
      - `phone` string, required — PSE payer phone number
      - `email` string, required — PSE payer email
      - `bank_code` string, nullable — PSE payer bank code
    - `transfers_instruction` object, nullable
      - `account` string, required — CVU/CBU/Alias account number
      - `type` 'CVU' | 'CBU' | 'ALIAS', required — Account type (CVU, CBU, or ALIAS)
      - `tax_id` string, nullable — CUIT/CUIL (normalized, digits only)
    - `ted_instruction` object, nullable
      - `beneficiary_name` string, required
      - `tax_id` string, required
      - `bank_code` string, required
      - `bank_name` string, required
      - `branch_code` string, required
      - `account_number` string, required
      - `account_type` string, required
  - `billing_fee_amount` number, nullable — BlindPay fee in cents accrued to your billing cycle (charged at the end of the month). Virtual account deposits below $100.00 always accrue here, so small deposits are delivered in full.
  - `transaction_fee_amount` number, nullable — BlindPay fee in cents deducted from the transaction at the time it is processed. Virtual account deposits of $100.00 or more are charged here (unless your instance is configured for end-of-month billing, in which case every fee accrues to billing_fee_amount).
  - `blindpay_bank_details` object, required
    - `routing_number` string
    - `account_number` string
    - `account_type` string
    - `swift_bic_code` string, nullable
    - `ach` object, nullable
      - `routing_number` string, required
      - `account_number` string, required
    - `wire` object, nullable
      - `routing_number` string, required
      - `account_number` string, required
    - `rtp` object, nullable
      - `routing_number` string, required
      - `account_number` string, required
    - `beneficiary` object, required
      - `name` string
      - `address_line_1` string
      - `address_line_2` string
    - `receiving_bank` object, required
      - `name` string
      - `address_line_1` string
      - `address_line_2` string
    - `swift_account_number` string, nullable
    - `swift_receiving_bank` object, nullable
      - `name` string, nullable
      - `address_line_1` string, nullable
      - `address_line_2` string, nullable
  - `customer_id` string, nullable
  - `receiver_amount` number, nullable — 10.10 USDC
  - `payment_method` 'ach' | 'wire' | 'pix' | 'ted' | 'spei' | 'transfers' | 'pse' | 'international_swift' | 'rtp', nullable
  - `sender_amount` number, nullable — 52.40 BRL needs to be sent in a pix transfer

## Acknowledgement `200`

Payin created

---

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