Submit payment from link

post

https://api.valmarpayments.com/transactions/payment-links/{uuid}/submit

Submits a payment through a payment link. Public endpoint — no authentication required. The customer provides their bank account details to complete the transaction.

Path Params

uuid

required

Payment link UUID

Body Params

Payment submission details

accountNumber

string

accountType

string

enum

"checking" or "savings"

Allowed:

amount

integer

Required if payment link amount is nil

chirpRequestCode

string

ChirpRequestCode is set when the payer verified their bank via Chirp IFV.
When present, account/routing numbers and the balance gate are resolved from
the stored ChirpBankLink record rather than the request body.

string

geolocation

object

Geolocation carries the payer's browser-reported coordinates. Required
when the merchant has geolocation verification enabled; the server
re-resolves the coordinates to a US state and enforces the same-state
rule regardless of any client-side pre-check.

name

string

phone

string

Phone is the payer-provided phone number. Persisted on the customer when a
new customer is created from this submission.

plaidAccountId

string

PlaidAccountId is the specific account (within the connected Plaid item) the
payer chose to pay from. Optional; when empty the item's primary account is
used. Lets a payer switch among the accounts they already connected without
re-running Plaid Link.

plaidItemId

string

routingNumber

string

Responses

200Payment submitted

400Invalid request body or business validation failure

404Resource not found

410Payment link expired or already used

500Internal server error