Reference
Client API Reference
Reference for public client API endpoints under /client/v1.
Client API endpoints authenticate with Payflow API keys.
Base URL:
https://api.ftosllc.co/client/v1Payments
| Method | Path | Auth | Description |
|---|---|---|---|
POST | /payments | API key, secret recommended | Create a sandbox hosted checkout payment. |
POST | /payments/component | API key | Prepare an embedded card component payment. |
POST | /payments/component/:payflowReference/confirm | Secret key | Confirm a Stripe or Square component result. |
ACH
| Method | Path | Auth | Description |
|---|---|---|---|
POST | /ach/customer-tokens | Secret key | Create an encrypted customer token. |
POST | /ach/transfers/preview | Secret key | Preview ACH transfer routing and fees. |
POST | /ach/transfers | Secret key | Create a Dwolla-backed ACH transfer. |
Common headers
Authorization: Bearer sk_test_...
Content-Type: application/json
X-Request-Id: optional-stable-id
X-Payflow-SDK: optional-sdk-name
X-Payflow-SDK-Version: optional-sdk-versionCommon payment request object
{
"amountMinor": "2500",
"currency": "USD",
"paymentMethod": "web_card",
"description": "Payment description",
"customer": {
"name": "Customer Name",
"email": "[email protected]"
},
"metadata": {
"orderId": "order_123"
}
}Hosted checkout response fields
| Field | Meaning |
|---|---|
payflowReference | Stable Payflow payment reference. |
status | Usually prepared at creation time. |
provider | Selected provider, such as stripe or square. |
routing | Rule metadata used for provider selection. |
checkoutUrl | Provider-hosted checkout URL. |
preparedAt | Preparation timestamp. |
Component response fields
| Component type | Fields |
|---|---|
stripe_payment_element | publishableKey, clientSecret, paymentIntentId |
square_web_payments | applicationId, locationId, environment, amountMinor, currency |
ACH transfer request object
{
"idempotencyKey": "unique-business-action",
"amountMinor": "12500",
"currency": "USD",
"customerToken": "eyJ...",
"routingNumber": "222222226",
"accountNumber": "123456789",
"bankAccountType": "checking",
"bankName": "Test Bank",
"accountName": "Jane Stone",
"description": "ACH transfer",
"metadata": {},
"remittanceData": {}
}Do not log full bank account numbers or customer tokens.