Skip to main content
POST
/
api
/
v2.1
/
fintrans
/
{accountId}
/
payment-consents
/
types
/
{operationType}
Create payment consent
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/fintrans/{accountId}/payment-consents/types/{operationType} \
  --header 'Content-Type: application/json' \
  --data '
{
  "maxAmount": {
    "value": "<string>",
    "scale": 123,
    "currency": "<string>"
  },
  "allowedBeneficiaries": [
    "<string>"
  ],
  "validFrom": "<string>",
  "validUntil": "<string>",
  "description": "<string>",
  "title": "<string>",
  "paymentType": "<string>",
  "parameters": {
    "maxAmount": 123,
    "currency": "<string>",
    "allowedOperations": [
      "<string>"
    ]
  }
}
'

​
Sample cURL

curl --request POST \
  --url 'https://sandbox.finhub.cloud/api/v2.1/fintrans/{accountId}/payment-consents/types/{operationType}' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'X-Tenant-Id: <TENANT_ID>' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'User-Agent: <USER_AGENT>' \
  --header 'X-Forwarded-From: <FORWARDED_FROM>' \
  --header 'platform: Web' \
  --header 'deviceId: <DEVICE_ID>' \
  --data '{
    "paymentType": "TRANSFER",
    "title": "Business Payment Consent for TRANSFER",
    "description": "Organization consent for TRANSFER transaction processing",
    "parameters": {
      "validity": {
        "startDate": "2026-01-01",
        "endDate": "2026-02-01",
        "maxUsageCount": 500
      },
      "limits": {
        "maxAmountPerTransaction": { "amount": 10000, "currency": "EUR" },
        "maxAmountPerDay": { "amount": 50000, "currency": "EUR" },
        "maxAmountPerMonth": { "amount": 200000, "currency": "EUR" },
        "maxTransactionsPerDay": 50,
        "maxTransactionsPerWeek": 250
      },
      "beneficiaries": {
        "allowedAccounts": [
          "DE89370400440532013000",
          "FR1420041010050500013M02606",
          "NL91ABNA0417164300",
          "BE68539007547034"
        ],
        "allowedTypes": ["INTERNAL", "SEPA", "SWIFT"],
        "allowNewBeneficiaries": false,
        "requireBeneficiaryName": true
      }
    }
  }'

Headers

​
X-Tenant-ID
string
​
X-User-ID
string

Path Parameters

​
accountId
string
required
​
operationType
string
required

Body

application/json
​
maxAmount
object
​
allowedBeneficiaries
string[]
​
validFrom
string
​
validUntil
string
​
description
string
​
title
string
​
paymentType
string
​
parameters
object

Response

200

OK