Get Details for Transfer

GET

Query

transferDetails

{entry}

{transferId}

curl --request GET \
  --url https://api-sandbox.payabli.com/api/Query/transferDetails/{entry}/{transferId} \
  --header 'requestToken: <api-key>'

{
  "Summary": {
    "achReturns": -50,
    "adjustments": 10,
    "billingFees": 25,
    "chargebacks": 0,
    "grossTransferAmount": 1000,
    "releaseAmount": 0,
    "thirdPartyPaid": 0,
    "totalNetAmountTransfer": 935,
    "serviceFees": 30,
    "transferAmount": 935,
    "refunds": -20,
    "heldAmount": 0,
    "totalRecords": 1,
    "totalAmount": 1000,
    "totalNetAmount": 935,
    "totalPages": 1,
    "pageSize": 20,
    "pageIdentifier": "XYZ123ABC456"
  },
  "Records": [
    {
      "transferDetailId": 654321,
      "transferId": 12345,
      "transactionId": "txn-4321hg6543fe",
      "paypointId": 1357,
      "type": "credit",
      "category": "sale",
      "method": "card",
      "grossAmount": 1000,
      "chargeBackAmount": 0,
      "returnedAmount": 0,
      "refundAmount": 20,
      "holdAmount": 0,
      "releasedAmount": 0,
      "billingFeesAmount": 25,
      "thirdPartyPaidAmount": 0,
      "adjustmentsAmount": 10,
      "netTransferAmount": 935,
      "splitFundingAmount": 0,
      "billingFeesDetails": [
        {
          "description": "Transaction fee",
          "category": "Service Fee",
          "fixPrice": 25,
          "floatPrice": 0,
          "billableAmount": 1000,
          "billAmount": 25,
          "frequency": "per transaction",
          "serviceGroup": "transaction fees"
        }
      ],
      "ParentOrgName": "GadgetPro",
      "PaypointDbaname": "Global Gadgets",
      "PaypointLegalname": "Global Gadgets, LLC",
      "PaypointEntryname": "48ae10920",
      "PaymentTransId": "txn-4321hg6543fe",
      "ConnectorName": "gp",
      "GatewayTransId": "TRN_K6Nz3JxrNKkaPTF4ExCqfO4UwMW4CM",
      "OrderId": "order789",
      "Method": "ach",
      "BatchNumber": "batch_226_ach_12-30-2023",
      "BatchAmount": 30.22,
      "PayorId": 1551,
      "PaymentData": {
        "MaskedAccount": "411812XXXXXX2357",
        "AccountType": "visa",
        "AccountExp": "08/28",
        "HolderName": "Ara Karapetyan",
        "orderDescription": "Electronics Purchase",
        "totalAmount": 1000,
        "serviceFee": 25,
        "currency": "USD"
      },
      "TransStatus": 1,
      "PaypointId": 1357,
      "TotalAmount": 1000,
      "NetAmount": 935,
      "FeeAmount": 1,
      "SettlementStatus": 2,
      "Operation": "Sale",
      "ResponseData": {
        "response": "Approved",
        "responsetext": "Transaction successful",
        "authcode": "123456",
        "transactionid": "TRN_K6Nz3JxrNKkaPTF4ExCqfO4OOOOOX",
        "response_code": "100",
        "response_code_text": "Operation successful."
      },
      "Source": "web",
      "ScheduleReference": 0,
      "OrgId": 9876,
      "RefundId": 0,
      "ReturnedId": 0,
      "TransAdditionalData": null,
      "InvoiceData": {
        "invoiceNumber": "INV-987654",
        "invoiceDate": "2024-01-04",
        "invoiceDueDate": "2024-02-04",
        "invoiceStatus": 4,
        "invoiceType": 1,
        "frequency": "monthly",
        "paymentTerms": "NET30",
        "termsConditions": "Thank you for your business",
        "tax": 0,
        "discount": 0,
        "invoiceAmount": 1000,
        "items": [
          {
            "itemCode": "ELEC123",
            "description": "Electronics",
            "quantity": 1,
            "unitPrice": 1000,
            "total": 1000
          }
        ]
      },
      "TransactionTime": "2024-01-05T12:15:30.11",
      "Customer": {
        "Identifiers": [
          "customerId",
          "email"
        ],
        "FirstName": "Ara",
        "LastName": "Karapetyan",
        "CompanyName": "Ara's Electronics",
        "BillingAddress1": "7890 Tech Park Drive",
        "BillingAddress2": "Suite 200",
        "BillingCity": "Baltimore",
        "BillingState": "MD",
        "BillingZip": "21230",
        "BillingCountry": "US",
        "BillingPhone": "(410) 555-0222",
        "BillingEmail": "ara.karapetyan@electronics.com",
        "CustomerNumber": "0010",
        "ShippingAddress1": "7890 Tech Park Drive",
        "ShippingAddress2": "Suite 200",
        "ShippingCity": "Baltimore",
        "ShippingState": "MD",
        "ShippingZip": "21230",
        "ShippingCountry": "US",
        "customerId": 7890,
        "customerStatus": 1,
        "AdditionalData": {
          "clientId": "client456",
          "invoiceScheduled": "true",
          "invoiceFrequency": "monthly",
          "customField1": "value1",
          "customField2": "value2"
        },
        "CreatedAt": "2024-01-05T10:45:00"
      },
      "CfeeTransactions": [],
      "splitFundingInstructions": [],
      "TransactionEvents": [
        {
          "eventType": "Sale",
          "eventTimestamp": "2024-01-05T12:15:30.11",
          "eventDetails": "Transaction completed successfully."
        }
      ]
    }
  ]
}

You must remove parameters= from the request before you send it, otherwise Payabli will ignore the filters.

Because of a technical limitation, you can’t make a request that includes filters from the API console on this page. The response won’t be filtered. Instead, copy the request, remove parameters= and run the request in a different client.

For example:

—url https://api-sandbox.payabli.com/api/Query/transactions/org/236?parameters=totalAmount(gt)=1000&limitRecord=20

should become:

—url https://api-sandbox.payabli.com/api/Query/transactions/org/236?totalAmount(gt)=1000&limitRecord=20

Authorizations

requestToken

string

header

required

Most endpoints require an organization token. Some endpoints require an application token, and those endpoints are noted.

Path Parameters

entry

string

required

The paypoint's entrypoint identifier. Learn more

Example:

"8cfec329267"

transferId

integer

required

Transfer identifier.

Query Parameters

limitRecord

integer

default:20

Max number of records to return for the query. Use 0 or negative value to return all records.

Example:

0

fromRecord

integer

default:0

The number of records to skip before starting to collect the result set.

Example:

251

sortBy

string

The field name to use for sorting results. Use desc(field_name) to sort descending by field_name, and use asc(field_name) to sort ascending by field_name.

Example:

"desc(field_name)"

parameters

object

Collection of field names, conditions, and values used to filter the query. See Filters and Conditions Reference for more information.

List of field names accepted:

grossAmount (gt, ge, lt, le, eq, ne)
chargeBackAmount (gt, ge, lt, le, eq, ne)
returnedAmount (gt, ge, lt, le, eq, ne)
billingFeeAmount (gt, ge, lt, le, eq, ne)
thirdPartyPaidAmount (gt, ge, lt, le, eq, ne)
netFundedAmount (gt, ge, lt, le, eq, ne)
adjustmentAmount (gt, ge, lt, le, eq, ne)
splitFundingAmount (gt, ge, lt, le, eq, ne)
operation (in, nin, eq, ne)
transactionId (eq, ne, in, nin)
category (eq, ne, ct, nct)
type (eq, ne, in, nin)
method (eq, ne, in, nin)

Response

200

application/json

Success

Summary

object

Summary.achReturns

number

ACH returns deducted from the batch.

Example:

-3.8

Summary.adjustments

number

Corrections applied to Billing & Fees charges.

Example:

0

Summary.billingFees

number

Charges applied for transactions and services.

Example:

15.09

Summary.chargebacks

number

Chargebacks deducted from batch.

Example:

0

Summary.grossTransferAmount

number

The gross batch amount before deductions.

Example:

7.89

Summary.releaseAmount

number

Previously held funds that have been released after a risk review.

Example:

0

Summary.thirdPartyPaid

number

Payments captured in the batch cycle that are deposited separately. For example, checks or cash payments recorded in the batch but not deposited via Payabli, or card brands making a direct transfer in certain situations.

Example:

0

Summary.totalNetAmountTransfer

number

The gross batch amount minus service fees.

Example:

3765.39

Summary.serviceFees

number

Service fees are any pass-through fees charged to the customer at the time of payment. These are not transferred to the merchant when the batch is transferred and funded.

Example:

0

Summary.transferAmount

number

The transfer amount is the net batch amount plus or minus any returns, refunds, billing and fees items, chargebacks, adjustments, and third party payments. This is the amount from the batch that is transferred to the merchant bank account.

Example:

0

Summary.refunds

number

Refunds deducted from batch.

Example:

0

Summary.heldAmount

number

Funds being held for fraud or risk concerns.

Example:

76.32

Summary.totalRecords

integer | null

Number of records in the response.

Example:

129

Summary.totalAmount

number | null

The total sum of the transfers in the response.

Example:

29092.32

Summary.totalNetAmount

number | null

The total sum of the transfers in the response.

Example:

29092.32

Summary.totalPages

integer | null

Number of pages in the response.

Example:

2

Summary.pageSize

integer | null

Number of records per page.

Example:

10

Summary.pageIdentifier

string | null

Auxiliary validation used internally by payment pages and components.

Example:

null

Records

object[]

Records.ParentOrgName

string | null

The name of the parent organization.

Example:

"PropertyManager Pro"

Records.PaypointDbaname

string | null

Paypoint's DBA name.

Example:

"Sunshine Gutters"

Records.PaypointLegalname

string | null

Paypoint's legal name.

Example:

"Sunshine Services, LLC"

Records.PaypointEntryname

string | null

Paypoint's entryname.

Maximum length: 50

Example:

"d193cf9a46"

Records.PaymentTransId

string | null

Unique Transaction ID.

Example:

"226-fe55ec0348e34702bd91b4be198ce7ec"

Records.ConnectorName

string | null

Connector used for transaction.

Example:

"gp"

Records.ExternalProcessorInformation

string | null

Processor information, used for troubleshooting and reporting. This field contains a value when the API key used to make the request has management permissions.

Example:

"[MER_xxxxxxxxxxxxxx]/[NNNNNNNNN]"

Records.GatewayTransId

string | null

Internal identifier used for processing.

Example:

"TRN_xwCAjQorWAYX1nAhAoHZVfN8iYHbI0"

Records.OrderId

string | null

Custom identifier for the transaction.

Maximum length: 250

Example:

"O-5140"

Records.Method

string | null

Payment method used: card, ach, or wallet.

Example:

"ach"

Records.BatchNumber

string | null

Batch number.

Example:

"batch_226_ach_12-30-2023"

Records.BatchAmount

number | null

Batch amount.

Example:

30.22

Records.PayorId

integer

Unique ID for customer linked to the transaction.

Example:

1551

Records.PaymentData

object

Records.PaymentData.MaskedAccount

string | null

Masked card or bank account used in transaction. In the case of Apple Pay, this is a masked DPAN (device primary account number).

Example:

"4XXXXXXXX1111"

Records.PaymentData.AccountType

string | null

Bank account type or card brand.

Example:

"visa"

Records.PaymentData.AccountExp

string | null

Expiration date of card used in transaction.

Example:

"11/29"

Records.PaymentData.AccountZip

string | null

ZIP code for card used in transaction.

Example:

"90210"

Records.PaymentData.HolderName

string | null

Account holder name for the method.

Example:

"Chad Mercia"

Records.PaymentData.orderDescription

string | null

Text description of the transaction.

Maximum length: 250

Example:

"Depost for materials for 123 Walnut St"

Records.PaymentData.StoredId

string | null

Identifier of stored payment method used in transaction.

Example:

"1ec55af9-7b5a-4ff0-81ed-c12d2f95e135-4440"

Records.PaymentData.Initiator

string | null

default:merchant

Strongly recommended The cardholder-initiated transaction (CIT) or merchant-initiated transaction (MIT) indicator for the transaction. If you don't specify a value, Payabli defaults to merchant.

Available values:

payor: For cardholder-initiated transactions
merchant: For merchant-initiated transactions

See Understanding CIT and MIT Indicators for more information.

Example:

"payor"

Records.PaymentData.StoredMethodUsageType

string | null

default:unscheduled

Strongly recommended The usage type for the stored method, used for merchant-initiated transactions (MIT). If you don't specify a value, Payabli defaults to unscheduled.

Available values:

unscheduled: This type is used for transactions that are one-time or otherwise not pre-scheduled.
subscription: This type is used for subscription payments. For example, monthly rental fees or ongoing service subscriptions.
recurring: This type is used for recurring payments that occur per a set plan. For example, splitting an HOA special assessment over 6 monthly payments.

See Understanding CIT and MIT Indicators for more information.

Example:

"subscription"

Records.PaymentData.Sequence

string | null

The order of the transaction for cardholder-initiated transaction (CIT) and merchant-initiated transaction (MIT) purposes. This field is automatically detected and populated by Payabli.

Available values:

first: The first use of the payment method. This is almost always a cardholder-initiated transaction.
subsequent: For merchant-initiated transactions after the first use of the payment method.

See Understanding CIT and MIT Indicators for more information.

Example:

"subsequent"

Records.PaymentData.accountId

string | null

Custom identifier for payment connector.

Maximum length: 250

Records.PaymentData.SignatureData

string | null

Example:

null

Records.PaymentData.binData

object

Object containing information related to the card. This object is null unless the payment method is card. If the payment method is Apple Pay, the binData will be related to the DPAN (device primary account number), not the card connected to Apple Pay.

Records.PaymentData.paymentDetails

object

Details about the payment.

Records.PaymentData.paymentDetails.totalAmount

number

required

Total amount to be charged. If a service fee is sent, then this amount should include the service fee."

Example:

100

Records.PaymentData.paymentDetails.serviceFee

number | null

Service fee to be deducted from the total amount. This amount must be a number, percentages aren't accepted. If you are using a percentage-based fee schedule, you must calculate the value manually.

Example:

0

Records.PaymentData.paymentDetails.currency

string | null

Currency code ISO-4217. If not code is provided the currency in the paypoint setting is taken. Default is USD.

Example:

"USD"

Records.PaymentData.paymentDetails.checkNumber

string | null

A check number to be used in the ach transaction. Required for payment method = 'check'.

Example:

"107"

Records.PaymentData.paymentDetails.checkImage

object | null

Object containing image of paper check.

Records.PaymentData.paymentDetails.categories

object[] | null

Array of payment categories/line items describing the amount to be paid Note: These categories are for information only and are not validated against the total amount provided.

Records.PaymentData.paymentDetails.splitFunding

object[] | null

Split funding instructions for the transaction. See Split a Transaction for more.

Records.TransStatus

integer

Status of transaction. See the docs for a full reference.

Example:

1

Records.PaypointId

integer

InternalId for paypoint.

Example:

226

Records.TotalAmount

number

Transaction total amount (including service fee or sub-charge)

Example:

30.22

Records.NetAmount

number | null

Net amount paid.

Example:

3762.87

Records.FeeAmount

number

Service fee or sub-charge applied.

Example:

1

Records.SettlementStatus

integer

Settlement status for transaction. See the docs for a full reference.

Example:

2

Records.Operation

string | null

The transaction's operation.

Example:

"Sale"

Records.ResponseData

object

The transaction's response data.

Records.Source

string | null

Custom identifier to indicate the transaction or request source.

Maximum length: 100

Example:

"api"

Records.ScheduleReference

integer | null

Reference to the subscription that originated the transaction.

Example:

0

Records.OrgId

integer | null

ID of immediate parent organization.

Example:

123

Records.RefundId

integer | null

Identifier of refund transaction linked to this payment.

Example:

0

Records.ReturnedId

integer | null

Identifier of return/chargeback transaction linked to this payment.

Example:

0

Records.TransAdditionalData

any

Not currently in use.

Records.InvoiceData

object

Records.InvoiceData.invoiceNumber

string | null

Invoice number. Identifies the invoice under a paypoint.

Maximum length: 250

Example:

"INV-2345"

Records.InvoiceData.invoiceDate

string | null

Invoice date in any of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.

Example:

"2024-07-01"

Records.InvoiceData.invoiceDueDate

string | null

Invoice due date in one of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.

Example:

"2024-07-01"

Records.InvoiceData.invoiceType

integer | null

Type of invoice. Only 0 for one-time invoices is currently supported.

Example:

0

Records.InvoiceData.invoiceEndDate

string | null

Indicate the date to finish a scheduled invoice cycle (`invoiceType`` = 1) in any of the accepted formats: YYYY-MM-DD, MM/DD/YYYY.

Example:

"2024-07-01"

Records.InvoiceData.invoiceStatus

enum<integer> | null

Status for invoice.

The accepted status values are:

0 draft
1 active
2 partially paid
4 paid/complete
99 cancelled

Available options:

0,

1,

2,

4,

99

Example:

1

Records.InvoiceData.frequency

enum<string> | null

Frequency of scheduled invoice.

Available options:

one-time,

weekly,

every2weeks,

every6months,

monthly,

every3months,

annually

Example:

"monthly"

Records.InvoiceData.paymentTerms

enum<string> | null

Payment terms for invoice. If no terms are defined, then reponse data for this field defaults to N30.

Available options:

PIA,

CIA,

UR,

NET10,

NET20,

NET30,

NET45,

NET60,

NET90,

EOM,

MFI,

5MFI,

10MFI,

15MFI,

20MFI,

2/10NET30,

UF,

10UF,

20UF,

25UF,

50UF

Example:

"PIA"

Records.InvoiceData.termsConditions

string | null

Custom terms and conditions included in the invoice.

Example:

"Must be paid before work scheduled."

Records.InvoiceData.notes

string | null

Notes included in the invoice.

Example:

"Example notes."

Records.InvoiceData.tax

number | null

Tax rate in percent applied to the invoice.

Example:

2.05

Records.InvoiceData.discount

number | null

Discount applied to the invoice.

Example:

10

Records.InvoiceData.invoiceAmount

number | null

Invoice total amount.

Example:

105

Records.InvoiceData.freightAmount

number | null

Freight/shipping amount.

Example:

10

Records.InvoiceData.dutyAmount

number | null

Duty amount.

Example:

0

Records.InvoiceData.purchaseOrder

string | null

Purchase order number.

Example:

"PO-345"

Records.InvoiceData.firstName

string | null

First name of the recipient of the invoice.

Example:

"Chad"

Records.InvoiceData.lastName

string | null

Last name of the recipient of the invoice.

Example:

"Mercia"

Records.InvoiceData.company

string | null

Company name of the recipient of the invoice.

Example:

"ACME, INC"

Records.InvoiceData.shippingAddress1

string | null

The shipping address.

Maximum length: 250

Example:

"123 Walnut St"

Records.InvoiceData.shippingAddress2

string | null

Additional line for shipping address.

Maximum length: 100

Example:

"STE 900"

Records.InvoiceData.shippingCity

string | null

Shipping city.

Maximum length: 250

Example:

"Johnson City"

Records.InvoiceData.shippingState

string | null

Shipping state or province.

Example:

"TN"

Records.InvoiceData.shippingZip

string | null

Shipping ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: "37615-1234" or "37615".

Maximum length: 50

Example:

"37619"

Records.InvoiceData.shippingCountry

string | null

Shipping address country.

Example:

"US"

Records.InvoiceData.shippingEmail

string | null

Shipping recipient's contact email address.

Maximum length: 320

Example:

"example@email.com"

Records.InvoiceData.shippingPhone

string | null

Recipient phone number.

Example:

"5555555555"

Records.InvoiceData.shippingFromZip

string | null

Sender shipping ZIP code.

Example:

"30040"

Records.InvoiceData.summaryCommodityCode

string | null

Commodity code.

Example:

"501718"

Records.InvoiceData.items

object[] | null

Array of line items included in the invoice.

Records.InvoiceData.attachments

object | null

Array of fileContent objects with attached documents. Max upload size is 30 MB.

Records.InvoiceData.AdditionalData

string | null

Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. Example usage:

{
  "additionalData": {
    "key1": "value1",
    "key2": "value2",
    "key3": "value3"
  }
}

Example:

{
  "key1": "value1",
  "key2": "value2",
  "key3": "value3"
}

Records.EntrypageId

integer

If applicable, the internal reference ID to the payment page capturing the payment.

Example:

0

Records.TransactionTime

string | null

Transaction date and time, in UTC.

Example:

"2025-10-19T00:00:00"

Records.Customer

object

Records.Customer.CustomerId

integer | null

The Payabli-generated unique ID for the customer.

Example:

4440

Records.Customer.FirstName

string | null

Customer/Payor first name.

Example:

"John"

Records.Customer.LastName

string | null

Customer/Payor last name.

Example:

"Doe"

Records.Customer.CompanyName

string | null

Customer's company name.

Example:

"Sunshine LLC"

Records.Customer.CustomerNumber

string | null

User-provided unique identifier for the customer. This is typically the customer ID from your own system.

Maximum length: 250

Example:

"3456-7645A"

Records.Customer.BillingAddress1

string | null

Customer's billing address.

Example:

"1111 West 1st Street"

Records.Customer.BillingAddress2

string | null

Additional line for Customer's billing address.

Example:

"Suite 200"

Records.Customer.BillingCity

string | null

Customer's billing city.

Example:

"Miami"

Records.Customer.BillingState

string | null

Customer's billing state. Must be 2-letter state code for address in US.

Example:

"FL"

Records.Customer.BillingZip

string | null

Customer's billing ZIP code.

Example:

"45567"

Records.Customer.BillingCountry

string | null

Customer's billing country.

Example:

"US"

Records.Customer.BillingPhone

string | null

Customer's phone number.

Example:

"5555555555"

Records.Customer.BillingEmail

string | null

Customer's email address.

Maximum length: 320

Example:

"example@email.com"

Records.Customer.ShippingAddress1

string | null

The shipping address.

Maximum length: 250

Example:

"123 Walnut St"

Records.Customer.ShippingAddress2

string | null

Additional line for shipping address.

Maximum length: 100

Example:

"STE 900"

Records.Customer.ShippingCity

string | null

Shipping city.

Maximum length: 250

Example:

"Johnson City"

Records.Customer.ShippingState

string | null

Shipping state or province.

Example:

"TN"

Records.Customer.ShippingZip

string | null

Shipping ZIP code. For Pay In functions, this field supports 5-digit and 9-digit ZIP codes and alphanumeric Canadian postal codes. For example: "37615-1234" or "37615".

Maximum length: 50

Example:

"37619"

Records.Customer.ShippingCountry

string | null

Shipping address country.

Example:

"US"

Records.Customer.AdditionalData

string | null

Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. Example usage:

{
  "additionalData": {
    "key1": "value1",
    "key2": "value2",
    "key3": "value3"
  }
}

Example:

{
  "key1": "value1",
  "key2": "value2",
  "key3": "value3"
}

Records.Customer.CreatedAt

string

Timestamp of when record was created, in UTC.

Example:

"2022-07-01 15:00:01"

Records.Customer.customerId

integer | null

The Payabli-generated unique ID for the customer.

Example:

4440

Records.Customer.customerStatus

integer | null

Customer Status. Possible values:

-99 Deleted
0 Inactive
1 Active
85 Locked (typically due to multiple failed login attempts)

Example:

1

Records.Customer.Identifiers

any[] | null

Array of field names to be used as identifiers.

Example:

[
  "\\\"firstname\\\"",
  "\\\"lastname\\\"",
  "\\\"email\\\"",
  "\\\"customId\\\""
]

Records.CfeeTransactions

object[] | null

Service Fee or sub-charge transaction associated to the main transaction.

Records.splitFundingInstructions

object[] | null

Split funding instructions for the transaction. The total amount of the splits must match the total amount of the transaction.

Records.TransactionEvents

object[] | null

Events associated with this transaction.

Records.PendingFeeAmount

number | null

The difference between the configured pass-through fee and the fee amount sent in the request. When transfering funds, Payabli uses this field to deduct the fee difference and transfer the correct amount to the merchant.

When a paypoint is set up to absorb fees, and the pass-through fee sent with the request is less than the configured amount, the difference must be covered by the merchant. See Fee Configuration to learn more about pass-through fee settings.

Example:

2

Records.DeviceId

string | null

Identifier of registered cloud device used in the transaction.

Example:

"6c361c7d-674c-44cc-b790-382b75d1xxx"

Records.AchSecCode

string

Standard Entry Class (SEC) code is a a three letter code that describes how an ACH payment was authorized. Supported values are:

PPD (Prearranged Payment and Deposit) - Used for credits or debits where an accountholder authorizes a company to initiate either a single or recurring transaction to their personal bank account. Common examples include direct deposit of payroll, mortgage payments, or utility bills. This is the default value for subscription payments.
WEB (Internet-Initiated/Mobile Entry) - Used for debit entries when authorization is obtained from an accountholder via the internet or a wireless network. Common examples are online bill payments, ecommerce purchases, and mobile app payments where the consumer enters their banking information online.
TEL (Telephone-Initiated Entry) - Used for one-time debit entries where authorization is obtained from a consumer via telephone. Common examples are phone-based purchases or bill payments where the consumer provides their banking information over the phone.
CCD (Corporate Credit or Debit) - Used for fund transfers between business accounts. This code is specifically for business-to-business transactions. Common examples include vendor payments and other business-to-business payments.

Records.AchHolderType

enum<string> | null

default:personal

The bank's accountholder type: personal or business.

Available options:

personal,

business

Records.transferDetailId

number

The transfer detail ID.

Example:

436

Records.transferId

number

The transfer ID.

Example:

104

Records.transactionId

string

The transaction ID.

Example:

"249-f04bb62da..."

Records.paypointId

integer | null

The ID of the paypoint the transfer belongs to.

Example:

255

Records.type

string

The transaction type: credit or debit.

Example:

"debit"

Records.category

string

A field used internally by Payabli to categorize the transaction details. Values are:

auth: Any payment
refund: ACH return or Refund
adj: Adjustments
cb: Chargeback
split: Split amount

Example:

"auth"

Records.method

string

The payment method.

Example:

"card"

Records.grossAmount

number

Gross batch is the total amount of the payments grouped in the batch. This amount includes service fees.

Example:

4092.09

Records.chargeBackAmount

number

Amount of chargebacks to be deducted from batch.

Example:

0

Records.returnedAmount

number

Amount of ACH returns to be deducted from batch.

Example:

-3.8

Records.refundAmount

number

Amount of refunds to be deducted from batch.

Example:

-3.8

Records.holdAmount

number

Amount being held for fraud or risk concerns.

Example:

-25.97

Records.releasedAmount

number

Amount of previously held funds that have been released after a risk review.

Example:

0

Records.billingFeesAmount

number

Amount of charges and fees applied for services and transactions.

Example:

-0.05

Records.thirdPartyPaidAmount

number

Amount of payments captured in the batch cycle that are deposited separately. For example, checks or cash payments recorded in the batch but not deposited via Payabli, or card brands making a direct transfer in certain situations.

Example:

0

Records.adjustmentsAmount

number

Amount of corrections applied to Billing & Fees charges.

Example:

0

Records.netTransferAmount

number

Net transfer amount.

Example:

-1.76

Records.splitFundingAmount

number

Example:

0

Records.billingFeesDetails

object[]

Details about billing and fees items.

Was this page helpful?

Get List of Settled Transactions for Organization

Get a List of Transfers for Paypoint

curl --request GET \
  --url https://api-sandbox.payabli.com/api/Query/transferDetails/{entry}/{transferId} \
  --header 'requestToken: <api-key>'

{
  "Summary": {
    "achReturns": -50,
    "adjustments": 10,
    "billingFees": 25,
    "chargebacks": 0,
    "grossTransferAmount": 1000,
    "releaseAmount": 0,
    "thirdPartyPaid": 0,
    "totalNetAmountTransfer": 935,
    "serviceFees": 30,
    "transferAmount": 935,
    "refunds": -20,
    "heldAmount": 0,
    "totalRecords": 1,
    "totalAmount": 1000,
    "totalNetAmount": 935,
    "totalPages": 1,
    "pageSize": 20,
    "pageIdentifier": "XYZ123ABC456"
  },
  "Records": [
    {
      "transferDetailId": 654321,
      "transferId": 12345,
      "transactionId": "txn-4321hg6543fe",
      "paypointId": 1357,
      "type": "credit",
      "category": "sale",
      "method": "card",
      "grossAmount": 1000,
      "chargeBackAmount": 0,
      "returnedAmount": 0,
      "refundAmount": 20,
      "holdAmount": 0,
      "releasedAmount": 0,
      "billingFeesAmount": 25,
      "thirdPartyPaidAmount": 0,
      "adjustmentsAmount": 10,
      "netTransferAmount": 935,
      "splitFundingAmount": 0,
      "billingFeesDetails": [
        {
          "description": "Transaction fee",
          "category": "Service Fee",
          "fixPrice": 25,
          "floatPrice": 0,
          "billableAmount": 1000,
          "billAmount": 25,
          "frequency": "per transaction",
          "serviceGroup": "transaction fees"
        }
      ],
      "ParentOrgName": "GadgetPro",
      "PaypointDbaname": "Global Gadgets",
      "PaypointLegalname": "Global Gadgets, LLC",
      "PaypointEntryname": "48ae10920",
      "PaymentTransId": "txn-4321hg6543fe",
      "ConnectorName": "gp",
      "GatewayTransId": "TRN_K6Nz3JxrNKkaPTF4ExCqfO4UwMW4CM",
      "OrderId": "order789",
      "Method": "ach",
      "BatchNumber": "batch_226_ach_12-30-2023",
      "BatchAmount": 30.22,
      "PayorId": 1551,
      "PaymentData": {
        "MaskedAccount": "411812XXXXXX2357",
        "AccountType": "visa",
        "AccountExp": "08/28",
        "HolderName": "Ara Karapetyan",
        "orderDescription": "Electronics Purchase",
        "totalAmount": 1000,
        "serviceFee": 25,
        "currency": "USD"
      },
      "TransStatus": 1,
      "PaypointId": 1357,
      "TotalAmount": 1000,
      "NetAmount": 935,
      "FeeAmount": 1,
      "SettlementStatus": 2,
      "Operation": "Sale",
      "ResponseData": {
        "response": "Approved",
        "responsetext": "Transaction successful",
        "authcode": "123456",
        "transactionid": "TRN_K6Nz3JxrNKkaPTF4ExCqfO4OOOOOX",
        "response_code": "100",
        "response_code_text": "Operation successful."
      },
      "Source": "web",
      "ScheduleReference": 0,
      "OrgId": 9876,
      "RefundId": 0,
      "ReturnedId": 0,
      "TransAdditionalData": null,
      "InvoiceData": {
        "invoiceNumber": "INV-987654",
        "invoiceDate": "2024-01-04",
        "invoiceDueDate": "2024-02-04",
        "invoiceStatus": 4,
        "invoiceType": 1,
        "frequency": "monthly",
        "paymentTerms": "NET30",
        "termsConditions": "Thank you for your business",
        "tax": 0,
        "discount": 0,
        "invoiceAmount": 1000,
        "items": [
          {
            "itemCode": "ELEC123",
            "description": "Electronics",
            "quantity": 1,
            "unitPrice": 1000,
            "total": 1000
          }
        ]
      },
      "TransactionTime": "2024-01-05T12:15:30.11",
      "Customer": {
        "Identifiers": [
          "customerId",
          "email"
        ],
        "FirstName": "Ara",
        "LastName": "Karapetyan",
        "CompanyName": "Ara's Electronics",
        "BillingAddress1": "7890 Tech Park Drive",
        "BillingAddress2": "Suite 200",
        "BillingCity": "Baltimore",
        "BillingState": "MD",
        "BillingZip": "21230",
        "BillingCountry": "US",
        "BillingPhone": "(410) 555-0222",
        "BillingEmail": "ara.karapetyan@electronics.com",
        "CustomerNumber": "0010",
        "ShippingAddress1": "7890 Tech Park Drive",
        "ShippingAddress2": "Suite 200",
        "ShippingCity": "Baltimore",
        "ShippingState": "MD",
        "ShippingZip": "21230",
        "ShippingCountry": "US",
        "customerId": 7890,
        "customerStatus": 1,
        "AdditionalData": {
          "clientId": "client456",
          "invoiceScheduled": "true",
          "invoiceFrequency": "monthly",
          "customField1": "value1",
          "customField2": "value2"
        },
        "CreatedAt": "2024-01-05T10:45:00"
      },
      "CfeeTransactions": [],
      "splitFundingInstructions": [],
      "TransactionEvents": [
        {
          "eventType": "Sale",
          "eventTimestamp": "2024-01-05T12:15:30.11",
          "eventDetails": "Transaction completed successfully."
        }
      ]
    }
  ]
}

API Basics

Pay In Endpoints

Pay Out Endpoints

Pay Ops Endpoints

Object Models

Get Details for Transfer

Authorizations

Path Parameters

Query Parameters

Response