Create a controlled payment intent

Requires payment.create. Identical idempotent replays return the original resource; different material returns 409.

AuthorizationBearer

Scoped Lipafy API key, OAuth token, or dashboard token

This endpoint expects an object.

beneficiary_idstringRequiredformat: "uuid"

payment_typeenumRequired

amount_minorstringRequiredformat: "^[0-9]+$"

currencyenumRequired

purposestringRequired

account_referencestringOptional

scheduled_atdatetimeOptional

expires_atdatetimeOptional

Created or idempotently replayed intent

payment_intentobjectOptional

400

Bad Request Error

403

Forbidden Error

409

Conflict Error

$	curl -X POST https://api.lipafy.xyz/v1/payment-intents \
>	-H "Idempotency-Key: Idempotency-Key" \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"beneficiary_id": "string",
>	"payment_type": "SUPPLIER_PAYMENT",
>	"amount_minor": "125000",
>	"currency": "KES",
>	"purpose": "Fictional office utility bill"
>	}'