> ## Documentation Index > Fetch the complete documentation index at: https://docs.blips.network/llms.txt > Use this file to discover all available pages before exploring further. # Create same-currency incoming funding transfer > Create a same-currency incoming funding transfer from a bound external account into a customer internal account. ## OpenAPI ````yaml /openapi/blips-public-reference.yaml post /transfer-in openapi: 3.1.0 info: title: BLIPS Public Reference API version: '2026-04-08' description: >- Public OpenAPI 3.1 subset for the first BLIPS Mintlify API Reference and Playground release. This document is bound to the confirmed Public Test Backend at https://public-test.blips.network, includes only the approved first-release public endpoints, uses only internal `$ref` values, and excludes callback-only webhook documentation and operator-only surfaces. servers: - url: https://public-test.blips.network description: >- Confirmed Public Test Backend ingress target for public BLIPS API Reference, Playground, and internet-testable Try It flows. security: - BasicAuth: [] tags: - name: Platform Setup description: >- Bootstrap and platform configuration surfaces for establishing the public BLIPS integration context. - name: Sandbox API description: >- Sandbox-only externally displayed helper surfaces. These routes either adjust quote inputs or create incoming-payment review cases, but they always feed the existing quote or transaction families and never become second outward API families. - name: Tokens description: >- Platform-scoped API credential create, list, detail, and revoke operations. - name: Customers description: >- Customer onboarding, profile lifecycle, and PPV payment-address issuance surfaces. - name: Accounts description: >- Customer-bound internal-account and external-account surfaces kept in the first-layer public contract. - name: Same-Currency Transfers description: >- Same-currency receiver lookup plus incoming and outgoing transfer primitives. - name: Cross-Currency Transfers description: >- PPV-first receiver lookup, quote creation/readback, and quote execution for cross-currency flows. - name: Transactions description: Transaction readback plus bounded incoming-review decision operations. - name: Webhooks description: >- Webhook connectivity verification surface for the public BLIPS integration. paths: /transfer-in: post: tags: - Same-Currency Transfers summary: Create same-currency incoming funding transfer description: >- Create a same-currency incoming funding transfer from a bound external account into a customer internal account. operationId: createTransferIn parameters: - name: Idempotency-Key in: header required: false schema: type: string description: >- Optional idempotency key for safely retrying the same transfer-in request. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransferInMvpRequest' examples: customerDeposit: value: customerId: 019542f5-b3e7-1d02-0000-000000000001 platformCustomerId: partner_cust_9f8b2c7d source: accountId: e85dcbd6-dced-4ec4-b756-3c3a9ea3d965 destination: accountId: a12dcbd6-dced-4ec4-b756-3c3a9ea3d123 amount: 12550 description: Customer deposit responses: '201': description: Same-currency incoming funding transfer created. content: application/json: schema: $ref: '#/components/schemas/TransferInMvpResponse' examples: created: value: transactionId: txn_transfer_in_001 type: INCOMING status: COMPLETED customerId: 019542f5-b3e7-1d02-0000-000000000001 platformCustomerId: partner_cust_9f8b2c7d source: accountId: e85dcbd6-dced-4ec4-b756-3c3a9ea3d965 destination: accountId: a12dcbd6-dced-4ec4-b756-3c3a9ea3d123 amount: 12550 currency: USD description: Customer deposit createdAt: '2025-07-21T17:32:28Z' updatedAt: '2025-07-21T17:32:28Z' settledAt: '2025-07-21T17:32:28Z' '400': description: Invalid request body. content: application/json: schema: $ref: '#/components/schemas/TransferInMvpErrorResponse' examples: invalidInput: value: status: 400 code: INVALID_REQUEST message: Invalid request body details: {} '401': description: Invalid or missing API credentials. content: application/json: schema: $ref: '#/components/schemas/TransferInMvpErrorResponse' examples: unauthorized: value: status: 401 code: UNAUTHORIZED message: Invalid or missing API credentials details: {} '404': description: Customer or account not found. content: application/json: schema: $ref: '#/components/schemas/TransferInMvpErrorResponse' examples: customerOrAccountNotFound: value: status: 404 code: NOT_FOUND message: Customer or account not found details: {} '409': description: >- Transfer cannot proceed. Returned for same-currency validation failures or idempotency-key reuse with a different payload. content: application/json: schema: $ref: '#/components/schemas/TransferInMvpErrorResponse' examples: sameCurrencyMismatch: value: status: 409 code: SAME_CURRENCY_MISMATCH message: >- Transfer must use the same currency across source and destination details: {} idempotencyConflict: value: status: 409 code: IDEMPOTENCY_CONFLICT message: Idempotency-Key reuse with different payload details: method: POST path: /transfer-in '500': description: Internal service error. content: application/json: schema: $ref: '#/components/schemas/TransferInMvpErrorResponse' examples: internalServiceError: value: status: 500 code: INTERNAL_ERROR message: Internal service error details: {} security: - BasicAuth: [] components: schemas: TransferInMvpRequest: type: object additionalProperties: false required: - customerId - platformCustomerId - source - destination - amount properties: customerId: type: string description: >- BLIPS customer UUID that owns the bound external source account for this funding transfer. platformCustomerId: type: string description: Stable platform-side customer reference for the same customer. source: $ref: '#/components/schemas/TransferInMvpAccountRef' description: Bound external account that funds the same-currency transfer-in. destination: $ref: '#/components/schemas/TransferInMvpAccountRef' description: Internal account that receives the same-currency deposit. amount: type: integer minimum: 1 description: Transfer amount in minor units. description: type: string description: Optional deposit description stored with the transfer. TransferInMvpResponse: type: object additionalProperties: false required: - transactionId - type - status - customerId - platformCustomerId - source - destination - amount - currency - description - createdAt - updatedAt - settledAt properties: transactionId: type: string description: >- Canonical public transaction identifier for the created same-currency funding transfer. type: type: string enum: - INCOMING description: Same-currency incoming transfer type for this endpoint. status: type: string enum: - PENDING - PROCESSING - COMPLETED - FAILED description: Current same-currency funding transfer status. customerId: type: string description: BLIPS customer UUID that owns the transfer. platformCustomerId: type: string description: Platform-side customer reference echoed from the bound customer. source: $ref: '#/components/schemas/TransferInMvpAccountRef' description: Bound external source account. destination: $ref: '#/components/schemas/TransferInMvpAccountRef' description: Customer internal destination account. amount: type: integer minimum: 1 description: Same-currency transfer amount in minor units. currency: type: string description: >- ISO 4217 currency code shared by the source and destination accounts. description: type: string nullable: true description: >- Optional deposit description echoed from the create request when present. createdAt: type: string format: date-time description: Creation timestamp for the same-currency incoming transfer record. updatedAt: type: string format: date-time description: >- Last update timestamp for the same-currency incoming transfer record. settledAt: type: string format: date-time nullable: true description: Settlement timestamp when the incoming transfer has completed. TransferInMvpErrorResponse: type: object description: Public error envelope for same-currency incoming transfer failures. additionalProperties: false required: - status - code - message - details properties: status: type: integer description: >- HTTP status code returned for the failed same-currency incoming transfer request. code: type: string description: >- Stable public error code for the failed same-currency incoming transfer request. message: type: string description: >- Human-readable summary of the same-currency incoming transfer failure. details: type: object nullable: true additionalProperties: true description: Additional structured error context when present. TransferInMvpAccountRef: type: object additionalProperties: false required: - accountId properties: accountId: type: string description: Stable BLIPS account identifier. securitySchemes: BasicAuth: type: http scheme: basic description: >- Integration-key Basic Auth (`clientId:clientSecret`) as documented in docs/public/AUTHENTICATION.md. ````