Retrieve transactions

Request

Retrieves a list of transactions.

Security

SecretApiKey or JWT or ApplicationJWT

Query

limitinteger, [ 0 .. 1000 ]

Limits the number of collection items to be returned.

offsetinteger, [ 0 .. 1000 ]

Specifies the starting point within the collection of items to be returned.

filterstring

Criteria for filtering collection items. This field requires a special format. Use , to specify multiple allowed values. Use ; to specify multiple fields.

For more information, see Search filters.

qstring

Use this field to perform a partial search of text fields.

sortArray of strings

Sorts and orders the collection of items. To sort in descending order, prefix with -. Multiple fields can be sorted by separating each with ,.

expandstring

Expands a request to include embedded objects within the _embedded property of the response. This field accepts a comma-separated list of objects.

For more information, see Embedded resources.

curl -i -X GET \
  'https://www.rebilly.com/_mock/catalog/all/transactions?limit=1000&offset=1000&filter=string&q=string&sort=string&expand=string' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'

Responses

List of transactions retrieved.

Headers

Pagination-Totalinteger

Total number of items.

Example:332

Pagination-Limitinteger

Maximum number of items per page.

Example:100

Pagination-Offsetinteger

Specifies the starting point within the collection of resource results. For example, a request with limit=20 retrieves and displays the first 20 results on a page. A following request with limit=20 and offset=20, retrieves the next page of 20 results.

Example:2

Bodyapplication/json

Array [

idstring, <= 50 characters(TransactionId)read-only

ID of the transaction.

Example:"txn_0YVDTQJ8YWDGQACV2N2N5SPWQ0"

websiteIdstring, <= 50 characters(WebsiteId)read-only

ID of the website. A website is where an organization obtains a customer. For more information, see Obtain an organization ID and website ID.

Example:"web_0YV7DE4Z26DQSA1AC92FBJ7SEG"

customerIdstring, <= 50 characters(CustomerId)

ID of the customer resource.

Example:"cus_0YV7DDSDD1C8DA64KHH2W33CPF"

typestringread-only

Type of transaction.

Enum:"3ds-authentication""authorize""capture""credit""refund""sale""setup""void"

statusstringread-only

Status of the transaction.

Enum:"completed""conn-error""disputed""never-sent""offsite""partially-refunded""pending""refunded""sending""timeout"

resultstringread-only

Result of the transaction.

Enum:"abandoned""approved""canceled""declined""unknown"

amountnumber, (double)read-only

Total amount of the transaction.

currencystring, = 3 characters(CurrencyCode)read-only

Currency code in ISO 4217 format.

Example:"USD"

purchaseAmountnumber, (double)read-only

Amount by which the purchase is completed. If an adjustment occurs, the purchased amount may differ from the requested amount.

purchaseCurrencystring, = 3 characters(CurrencyCode)read-only

Currency code in ISO 4217 format.

Example:"USD"

requestAmountnumber, (double)read-only

Amount of the payment request. If an adjustment occurs, the purchase amount may differ from the billing amount.

requestCurrencystring, = 3 characters(CurrencyCode)read-only

Currency code in ISO 4217 format.

Example:"USD"

parentTransactionIdstring or null, <= 50 characters(TransactionId)

ID of the parent transaction.

Example:"txn_0YVDTQJ8YWDGQACV2N2N5SPWQ0"

childTransactionsArray of stringsread-only

IDs of child transactions.

invoiceIdsArray of stringsread-only

Related invoice IDs.

subscriptionIdsArray of stringsread-only

Subscription IDs of invoices that are related to the transaction.

planIdsArray of stringsread-only

Plan IDs of orders that are related to the transaction.

isRebillbooleanread-only

Specifies if the transaction is one of a number of recurring payments in a subscription, excluding trials or setup fees.

rebillNumberintegerread-only

Rebill number of the transaction. A rebill number is the number of recurring payments in a subscription, excluding trials or setup fees.

billingAddressobject(ContactObject)

Billing address.

has3dsbooleanread-only

Specifies if the transaction uses 3D Secure.

3dsobjectread-only

Authentication object. For more information, see 3D Secure (3DS).

redirectUrlstring or null, (uri), <= 2083 characters

URL where the end-user is redirected to when an offsite transaction is completed. The default value is the website URL.

retryNumberintegerread-only

Position of the transaction in the sequence of retries.

isRetrybooleanread-only

Specifies if a transaction is a retry.

billingDescriptorstring or nullread-only

Billing descriptor that appears on the periodic billing statement. For a credit card statement, this field commonly contains 12 or fewer characters.

descriptionstring, <= 255 characters

Description of the payment.

requestIdstring

Request ID of the transaction. This ID must be unique within a 24-hour period. Use this field to prevent duplicate transactions.

hasAmountAdjustmentbooleanread-only

Specifies if the transaction has amount adjustment.

gatewayNamestring or null(GatewayName)read-only

Name of the payment gateway that processed, or is selected to process, the transaction. This value is only available after a gateway is selected for the transaction.

Enum:"A1Gateway""ACI""Adyen""Aera""Aircash""Airpay""Airwallex""AsiaPay""AmazonPay""AmexVPC"

customFieldsobject(ResourceCustomFields)

Use custom fields to extend a resource scheme to include custom data that is not provided as a common field. For more information, see Custom fields.

Default:{}

Example:

{
  "foo": "bar"
}

processedTimestring, (date-time)(ServerTimestamp)read-only

Date and time when the transaction is processed.

createdTimestring, (date-time)(CreatedTime)read-only

Date and time when the resource is created. This value is set automatically when the resource is created.

updatedTimestring, (date-time)(UpdatedTime)read-only

Date and time when the resource is updated. This value is set automatically when the resource is updated.

gatewayAccountIdstring or null, <= 50 charactersread-only

ID of the gateway account that processed the transaction.

Example:"gw_acc_0YVCXMF26DDNKAERE5NW727S34"

gatewayTransactionIdstring or null, <= 50 charactersread-only

ID of the gateway transaction.

Example:"txn_0YVDTQJ8YWDGQACV2N2N5SPWQ0"

gatewayobjectread-only

Related gateway information.

acquirerNamestring or null(AcquirerName)read-only

Acquirer name. This value is only available when a transaction uses a payment gateway. If a transaction does not use a payment gateway, this value is null.

Enum:"Adyen""ACI""Aera""Alipay""AIB""Aircash""Airpay""AmazonPay""ApcoPay""AsiaPaymentGateway"

velocityinteger

Number of transactions by the same customer in the past 24 hours.

revisionintegerread-only

Number of times the transaction data has been modified.

This revision number is useful when analyzing webhook data to determine if the change takes precedence over the current representation.

referenceDataobject or nullread-only

Transaction reference data.

Example:

{
  "gatewayTransactionId": "GAT123"
}

binstring or null, (bin)read-only

Payment card Bank Identification Number (BIN).

paymentInstrumentVaulted payment instrument (object) or Alternative instrument (object) or Cash (object) or Check (object)

One of:

Vaulted payment instrument.

To use this payment instrument for automatic subscription renewals, and for transactions when no specific payment instrument is provided by the user, set this as the default payment instrument.

hasDccbooleanread-only

Specifies if Dynamic Currency Conversion (DCC) applies to the transaction.

dccobject or nullread-only

Detailed Dynamic currency conversion (DCC). If DCC is not applied to the transaction, this value is null.

riskScoreintegerread-only

Risk score for the transaction.

riskMetadataRisk metadata (object) or null

One of:

Risk metadata used for 3D Secure and risk scoring.

notificationUrlstring or null, (uri), <= 2083 characters

URL where a server-to-server POST notification is sent. This notification is sent when the transaction result is finalized after a timeout or an offsite interaction.

Do not interpret this notification as a confirmation, complete a GET request to confirm the result of the transaction. To ensure the request is not reattempted, when the result is confirmed, respond with a 2xx HTTP status code.

The following placeholders are available to use in this URI: {id} and {result}. These placeholders are replaced the with the transaction ID and result accordingly.

isDisputedbooleanread-only

Specifies if a transaction is disputed.

disputeTimestring or null, (date-time)read-only

Date and time when the dispute is created. If the transaction is not disputed, this value is null.

disputeStatusstring or nullread-only

Status of the dispute.

Enum:null"response-needed""under-review""forfeited""won""lost""unknown"

isReconciledbooleanread-only

Specifies if the transaction is verified with gateway batch data.

isProcessedOutsideboolean

Specifies if the transaction is processed outside of Rebilly.

isMerchantInitiatedboolean

Specifies if the transaction is initiated by the merchant.

hadDiscrepancybooleanread-only

Specifies if the transaction is updated due to a discrepancy with its source of truth.

arnstring or nullread-only

Acquirer reference number.

Example:"74836950144358910018150"

reportAmountnumber, (double)read-only

Transaction amount converted to the report currency of the organization.

reportCurrencystring, = 3 characters(CurrencyCode)read-only

Currency code in ISO 4217 format.

Example:"USD"

settlementTimestring or null, (date-time)read-only

Date and time when the transaction is settled by the banking institution.

discrepancyTimestring or null, (date-time)read-only

Date and time of the most recent discrepancy on the transaction.

limitsobject or null(LimitAmount)

Transaction amount limit information.

organizationIdstring, <= 50 characters(OrganizationId)read-only

Unique organization identifier. An organization is an entity that represents a company. For more information, see Obtain an organization ID.

Example:"org_0YVDM8RC7GDADADSBSMW124JA8"

depositRequestIdstring or null, <= 50 charactersread-only

ID of the deposit request if applicable. The created transaction is based on the properties of this deposit request.

Example:"dep_req_0YVJ65BSGYC3EAT58SEX8KY6J7"

transferIdstring or null, <= 50 charactersread-only

ID of the ledger transfer if applicable. The transaction is linked to this transfer when processed in the wallet ledger.

Example:"tb_0YVDTQJ8YWDGQACV2N2N5SPWQ0"

payoutRequestIdstring or null, <= 50 charactersread-only

ID of the payout request if applicable. The created transaction is based on the properties of this payout request.

Example:"pout_req_0YVDMDE2BMC6KBB5MX76RF6T80"

_linksArray of objectsread-only

Related links.

_embeddedobjectread-only

Embedded objects that are requested by the expand query parameter.

methodstring(PaymentMethod)deprecated

Payment method.

Note: Use paymentInstrument.method instead.

Enum:"payment-card""ach""cash""check""paypal""AdvCash""Aera""Affirm""Afterpay""Aircash"

orderIdstringdeprecated

Order ID of the transaction. This ID must be unique within a 24 hour period.

Note: Use the requestId field instead.

]

Response

[
  {
    "id": "txn_0YVDTQJ8YWDGQACV2N2N5SPWQ0",
    "websiteId": "web_0YV7DE4Z26DQSA1AC92FBJ7SEG",
    "customerId": "cus_0YV7DDSDD1C8DA64KHH2W33CPF",
    "type": "3ds-authentication",
    "status": "completed",
    "result": "abandoned",
    "amount": 0.1,
    "currency": "USD",
    "purchaseAmount": 0.1,
    "purchaseCurrency": "USD",
    "requestAmount": 0.1,
    "requestCurrency": "USD",
    "parentTransactionId": "txn_0YVDTQJ8YWDGQACV2N2N5SPWQ0",
    "childTransactions": [ … ],
    "invoiceIds": [ … ],
    "subscriptionIds": [ … ],
    "planIds": [ … ],
    "isRebill": true,
    "rebillNumber": 0,
    "billingAddress": { … },
    "has3ds": true,
    "3ds": { … },
    "redirectUrl": "http://example.com",
    "retryNumber": 0,
    "isRetry": true,
    "billingDescriptor": "string",
    "description": "string",
    "requestId": "string",
    "hasAmountAdjustment": true,
    "gatewayName": "A1Gateway",
    "customFields": { … },
    "processedTime": "2019-08-24T14:15:22Z",
    "createdTime": "2019-08-24T14:15:22Z",
    "updatedTime": "2019-08-24T14:15:22Z",
    "gatewayAccountId": "gw_acc_0YVCXMF26DDNKAERE5NW727S34",
    "gatewayTransactionId": "txn_0YVDTQJ8YWDGQACV2N2N5SPWQ0",
    "gateway": { … },
    "acquirerName": "Adyen",
    "method": "payment-card",
    "velocity": 0,
    "revision": 0,
    "referenceData": { … },
    "bin": "string",
    "paymentInstrument": { … },
    "hasDcc": true,
    "dcc": { … },
    "riskScore": 0,
    "riskMetadata": { … },
    "notificationUrl": "http://example.com",
    "isDisputed": true,
    "disputeTime": "2019-08-24T14:15:22Z",
    "disputeStatus": null,
    "isReconciled": true,
    "isProcessedOutside": true,
    "isMerchantInitiated": true,
    "hadDiscrepancy": true,
    "orderId": "string",
    "arn": "74836950144358910018150",
    "reportAmount": 0.1,
    "reportCurrency": "USD",
    "settlementTime": "2019-08-24T14:15:22Z",
    "discrepancyTime": "2019-08-24T14:15:22Z",
    "limits": { … },
    "organizationId": "org_0YVDM8RC7GDADADSBSMW124JA8",
    "depositRequestId": "dep_req_0YVJ65BSGYC3EAT58SEX8KY6J7",
    "transferId": "tb_0YVDTQJ8YWDGQACV2N2N5SPWQ0",
    "payoutRequestId": "pout_req_0YVDMDE2BMC6KBB5MX76RF6T80",
    "_links": [ … ],
    "_embedded": { … }
  }
]

Our Solutions

Products

Features

Solutions

About