Skip to main content
POST
/
transfer-in
Create same-currency incoming funding transfer
curl --request POST \
  --url https://public-test.blips.network/transfer-in \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
}
'
{ "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" }

Authorizations

​
Authorization
string
header
required

Integration-key Basic Auth (clientId:clientSecret) as documented in docs/public/AUTHENTICATION.md.

Headers

​
Idempotency-Key
string

Optional idempotency key for safely retrying the same transfer-in request.

Body

application/json
​
customerId
string
required

BLIPS customer UUID that owns the bound external source account for this funding transfer.

​
platformCustomerId
string
required

Stable platform-side customer reference for the same customer.

​
source
object
required

Bound external account that funds the same-currency transfer-in.

​
destination
object
required

Internal account that receives the same-currency deposit.

​
amount
integer
required

Transfer amount in minor units.

Required range: x >= 1
​
description
string

Optional deposit description stored with the transfer.

Response

Same-currency incoming funding transfer created.

​
transactionId
string
required

Canonical public transaction identifier for the created same-currency funding transfer.

​
type
enum<string>
required

Same-currency incoming transfer type for this endpoint.

Available options:
INCOMING
​
status
enum<string>
required

Current same-currency funding transfer status.

Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
​
customerId
string
required

BLIPS customer UUID that owns the transfer.

​
platformCustomerId
string
required

Platform-side customer reference echoed from the bound customer.

​
source
object
required

Bound external source account.

​
destination
object
required

Customer internal destination account.

​
amount
integer
required

Same-currency transfer amount in minor units.

Required range: x >= 1
​
currency
string
required

ISO 4217 currency code shared by the source and destination accounts.

​
description
string | null
required

Optional deposit description echoed from the create request when present.

​
createdAt
string<date-time>
required

Creation timestamp for the same-currency incoming transfer record.

​
updatedAt
string<date-time>
required

Last update timestamp for the same-currency incoming transfer record.

​
settledAt
string<date-time> | null
required

Settlement timestamp when the incoming transfer has completed.