Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

JustiFi Payments API

To charge a payment method the desired amount, you'll use a payment.You can choose whether to charge a payment method that's already beentokenized or tokenize a new one when you create the payment.If a payment fails, the status will reflect it and an error code will be returned.You can retrieve information about your payments and refund them if needed.

JustiFi Payments API is one of 27 APIs that JustiFi publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Payments. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 8 operations across 6 paths, and defines 17 schemas. It is described by OpenAPI 3.0.0.

Requests are made against a single base URL, https://api.justifi.ai/v1.

8 operations 6 paths 17 schemas 3 GET1 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
Base URL
https://api.justifi.ai/v1
Terms of Service
Resource Areas
1

Paths & Operations 8

Across 6 paths, the API surfaces 8 operations — 3 GET, 1 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Payments 8

To charge a payment method the desired amount, you'll use a payment. You can choose whether to charge a payment method that's already been tokenized or tokenize a new one when you…

POST
/payments
Create a Payment
CreatePayment 3 params body → 201400402
GET
/payments
List Payments
ListPayments 7 params → 200
GET
/payments/{id}
Get a Payment
GetPayment 2 params → 200
PATCH
/payments/{id}
Update a Payment
UpdatePayment 3 params body → 200
POST
/payments/{id}/capture
Capture a Payment
CapturePayment 3 params → 200201
POST
/payments/{id}/refunds
Refund a Payment
CreateRefund 3 params body → 201
POST
/payments/{id}/void
Void a Payment
VoidPayment 3 params → 200
GET
/payments/{id}/payment_balance_transactions
Get Payment Balance Transactions
GetPaymentBalanceTransactions 2 params → 200

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are BankAccountPayment (33 properties), CardPayment (33 properties), Card (13 properties), PaymentBalanceTransaction (11 properties). Each schema is shown below with its type and property counts.

CardPaymentMethod
object
4 properties
CardPayment
object
33 properties
BankAccount
object
7 properties
TransactionHold
object
2 properties
FeeResponse
object
A fee object in API responses. The fees array is empty in the Create Payment response — subscribe to payment webhook events (recommended) to receive the full f…
8 properties 2 required
Envelope
object
4 properties
BankAccountPayment
object
33 properties
Refund
object
10 properties
ReturnedFeeResponse
object
A returned fee object showing fee details returned to the merchant with a refund
7 properties 7 required
BankAccountPaymentMethod
object
4 properties
PaymentBalanceTransaction
object
11 properties
Envelope-list
object
4 properties
PaymentError
object
1 property
Fee
object
A fee object specifying type and amount
2 properties 2 required
Card
object
13 properties
ApplicationFee
object
5 properties
PageInfo
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

justifi-payments-api-openapi.yml Raw ↑

Other APIs JustiFi publishes across the network.

JustiFi Ach Return Fees API
JustiFi Address API
JustiFi API Credentials API
JustiFi Balance Transactions API
JustiFi Bank Account API
JustiFi Bind Insurance API
JustiFi Business API
JustiFi Checkouts API
JustiFi Disputes API
JustiFi Document API
JustiFi Fee Configurations API
JustiFi Identity API