POST
/
v1
/
payments
/
intents
curl https://api.geldstuck.com/v1/payments/intents \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionId": "tx_01HX3ZM...",
    "customerId": "cus_01HX3ZR...",
    "paymentMethodId": "pm_01HX3ZS...",
    "amount": 1850000,
    "currency": "EUR"
  }'

{
  "id": "pi_01HX3ZT...",
  "status": "requires_confirmation",
  "clientSecret": "pi_01HX3ZT_secret_..."
}
Payments are currently in closed beta. Request access.

​
Body

​
transactionId
string
required
The escrow transaction to fund.
​
customerId
string
required
​
paymentMethodId
string
required
​
amount
integer
required
In minor units. Must match the transaction’s amount.
​
currency
string
required

​
Returns

​
id
string
Payment intent ID (pi_...).
​
status
string
requires_confirmation, processing, succeeded, failed.
​
clientSecret
string
Pass to your client-side payment confirmation flow to complete any required customer action.
curl https://api.geldstuck.com/v1/payments/intents \
  -H "x-api-key: $GELDSTUCK_PUBLIC_KEY" \
  -H "x-api-secret: $GELDSTUCK_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionId": "tx_01HX3ZM...",
    "customerId": "cus_01HX3ZR...",
    "paymentMethodId": "pm_01HX3ZS...",
    "amount": 1850000,
    "currency": "EUR"
  }'

{
  "id": "pi_01HX3ZT...",
  "status": "requires_confirmation",
  "clientSecret": "pi_01HX3ZT_secret_..."
}