INinfini
Fund

Transfer funds to a UID

Changed on

Transfers funds from the authenticated organization to an Infini UID. Requires fund.withdraw permission.

V1 supports same-currency transfers in USDT, USDC, or USD only. source_currency is optional and defaults to token_type; when supplied, it must equal token_type. The transfer has no fee, so the amount deducted from the sender equals the amount received by the recipient.

request_id is optional. When supplied, it must be a UUID and acts as the idempotency key. A retry by the same organization with an already completed request_id returns status=completed and is_duplicate=true.

post/internal-transfer

Request

Headers

X-API-Key-IDstring required

32-character Base58 credential ID returned after public-key registration.

X-API-Timestampstring required

Unix timestamp in seconds; tolerance is ±300 seconds.

X-API-Noncestring required

16 cryptographically random bytes encoded as unpadded Base64URL; fresh on every attempt.

Digeststring required

SHA-256= followed by standard padded Base64 of SHA-256 of exact request body bytes. Required even for an empty body; included in the signing string.

Authorizationstring required

Use Ed25519 signature="BASE64_SIGNATURE", where BASE64_SIGNATURE is the standard padded Base64 signature. See /docs/en/4-authorization for the exact signing string.

Request body

request_idstring uuid

Optional idempotency key. Must be a UUID when supplied.

recipient_uidstring required

Recipient Infini UID. The UID cannot belong to the source organization.

token_type'USDT' | 'USDC' | 'USD' required

Recipient account currency.

source_currency'USDT' | 'USDC' | 'USD'

Source account currency. Defaults to token_type; V1 requires the same currency as token_type.

amountstring required

Positive amount deducted and received. USDT and USDC support up to six decimal places; USD supports up to two. V1 internal transfers have no fee.

notestring

Optional transfer note.

Example request

{
  "request_id": "4b4436ba-90a1-4f26-940d-97177a7a3400",
  "recipient_uid": "12345678",
  "token_type": "USDC",
  "source_currency": "USDC",
  "amount": "10.25",
  "note": "Customer refund"
}

Response

Standard response envelope

OR

Example response

{
  "data": {
    "request_id": "4b4436ba-90a1-4f26-940d-97177a7a3400",
    "status": "completed"
  }
}

Changes

  • b9ee797f5199Revision changes
    • breaking

      added the new required header request parameter X-API-Key-ID

    • breaking

      added the new required header request parameter X-API-Nonce

    • breaking

      added the new required header request parameter X-API-Timestamp

    • breaking

      the header request parameter Authorization became required

    • breaking

      the header request parameter Digest became required

    • breaking

      removed the media type application/json for the response with the status

    • breaking

      removed the media type application/json for the response with the status

    • warning

      deleted the header request parameter Date

  • a77090a3bdd5Revision changes
    • info

      endpoint added