v1

latestOpenAPI 3.1.02026-07-2685154311.7 KB

Flow

Create a new payin for a customer within Flow workflows

Creates a new payin transaction for a customer within a Flow workflow context. This endpoint initiates a payment workflow where the customer (merchant) can receive payments. The payin includes invoice data, supported assets, and generates a payment link for customer interaction.

post/entities/{entityDID}/flow/customers/{customerDID}/payins

Path parameters

entityDIDstring did required

Decentralized Identifier (DID)

Example:did:web:vasps.id:jxnl0411:at

The DID of the entity

customerDIDstring required

Customer DID identifier (this is the merchant/beneficiary in payin context)

Request body

refstring required

Client-provided reference (e.g., invoice number)

currencystring required

Currency code for the transaction (e.g., USD, EUR)

amountstring required

Transaction amount

supportedAssetsstring[]

List of supported assets for this transaction (CAIP-19 format, or fiat codes)

fallbackSettlementAddressesstring[] required

List of fallback settlement addresses (CAIP-10 or payto://) for the merchant

memostring

Optional transaction memo

Response

Payin created successfully