---
title: "Create SPEI pay-in"
method: POST
path: "/money/payins"
tags: ["money", "payins"]
---

# Create SPEI pay-in

`POST /money/payins`

Creates an MXN SPEI pay-in and returns the funding instructions (CLABE, reference, beneficiary, bank, expiration). Gated on PermKYBLocked + PermFundsDeposit.

## Headers

- `Idempotency-Key` string, required — Required client idempotency key; a duplicate submission with the same key is rejected with 409.

## Request body

- PayinsCreatePayinInput
  - `amount` string
  - `source_money_account_id` string

## Response `200`

OK

- PayinsPayinInstructionsView
  - `amount` string
  - `amount_symbol` string
  - `amount_view` MoneyfmtMoneyAmountView
    - `float` number, double, required
    - `formatted` MoneyfmtFormattedMoneyAmountView, required
      - `compact` string, required
      - `currency_sign` string, required
      - `currency_sign_position` string, required
      - `full` string, required
    - `precise` string, required
    - `symbol` string, required
    - `zero` boolean, required
  - `bank_name` string
  - `beneficiary_name` string
  - `clabe` string
  - `estimate_available` boolean
  - `estimated_usdc` string
  - `estimated_usdc_view` MoneyfmtMoneyAmountView
    - `float` number, double, required
    - `formatted` MoneyfmtFormattedMoneyAmountView, required
      - `compact` string, required
      - `currency_sign` string, required
      - `currency_sign_position` string, required
      - `full` string, required
    - `precise` string, required
    - `symbol` string, required
    - `zero` boolean, required
  - `expires_ts` string, date-time
  - `external_id` string
  - `payin_id` string
  - `rate` string
  - `reference` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `501` — Not Implemented
- `default` — Error response.

---

[API](https://skmtc.net/stablesea/apis/stable-sea-backend.md) · [All operations](https://skmtc.net/stablesea/apis/stable-sea-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stablesea/stable-sea-backend/revisions/06167cc3c94e/schema)