Skip to main content
POST
/
v1
/
payments
Produce a multi-step payment plan (no execution)
curl --request POST \
  --url https://api.fiet.finance/v1/payments \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientReference": "erp-payment-001",
  "corridorId": "usdc-eth->aud-bank",
  "amountIn": "1000000",
  "recipient": {
    "type": "bank",
    "name": "Acme Pty Ltd",
    "country": "AU",
    "account": {
      "bsb": "062000",
      "accountNumber": "12345678"
    }
  },
  "options": {
    "mode": "STANDARD"
  }
}
'
{
  "planId": "<string>",
  "steps": [
    {
      "stepId": "<string>",
      "status": "PENDING",
      "instructions": [
        {
          "kind": "EVM_CALL",
          "chainId": 123,
          "to": "<string>",
          "data": "<string>",
          "value": "<string>",
          "constraints": {
            "notAfter": "2023-11-07T05:31:56Z",
            "maxSlippageBps": 2500
          }
        }
      ],
      "custodianAction": {}
    }
  ]
}
This endpoint returns a multi-step payment plan (no execution). For step types and Digital Collect behaviour, see Payments.

Authorizations

​
Authorization
string
header
required

Basic Auth (assumed at gateway for MVP)

Body

application/json
​
clientReference
string
required
Maximum string length: 128
Example:

"erp-payment-001"

​
corridorId
string
required
Example:

"usdc-eth->aud-bank"

​
amountIn
string
required

Input amount (smallest units) as string

Example:

"1000000"

​
recipient
object
required

Recipient details (bank recipient, or digital collect recipient, etc.)

​
options
object

Response

Payment plan

​
planId
string
required
Example:

"plan_123"

​
steps
object[]
required