Donors transaction information

Learn how to use Suran API on the Suran Help Center.

>>>

GET /api/v2/pay/donors_transaction_information SESSION
Get online transaction information for all donors within a date range

Headers

Header name Description
Cookie
required 		Login session cookie
Provision
required 		Web/Mobile/API Provision UUID

Params

Param name Description
start_date
required

Upper bound for Settlement Date. Expects format YYYY-MM-DD

Validations:

  • Must be a String
end_date
required

Lower bound for Settlement Date. Expects format YYYY-MM-DD

Validations:

  • Must be a String

Returns

Code: 200

Description:

Donors Transaction Information

Param name Description
data
required

donors transaction information

Validations:

  • Must be a Hash
data[id]
required

ID of the donors transaction information

Validations:

  • Must be a String
data[type]
required

Validations:

  • Must be a String
data[attributes]
required

Attributes of the donors transaction information

Validations:

  • Must be a Hash
data[attributes][id]
required

ID of the transaction

Validations:

  • Must be a number.
data[attributes][DonorGUID]
required

GUID of the donor

Validations:

  • Must be a String
data[attributes][TransactionGUID]
required

GUID of the transaction

Validations:

  • Must be a String
data[attributes][AccountScheduleGUID]
required

GUID of the account schedule

Validations:

  • Must be a String
data[attributes][AccountGUID]
required

GUID of the account

Validations:

  • Must be a String
data[attributes][Amount]
required

amount of the transaction

Validations:

  • Must be a String
data[attributes][TransactionDate]
required

Date of the transaction

Validations:

  • Must be a String
data[attributes][SettlementDate]
required

Date of the settlement

Validations:

  • Must be a String
data[attributes][Status]
required

Status of the transaction

Validations:

  • Must be a String
data[attributes][DepositID]
required

ID of the deposit

Validations:

  • Must be a String
data[attributes][CreditID]
required

ID of the credit

Validations:

  • Must be a number.
data[attributes][IsRefundable]
required

Is the transaction refundable?

Validations:

  • Must be one of: t, f, true, false, 1, 0, y, n, yes, no.
data[attributes][RefundTransactionGUID]
required

GUID of the transaction refund (This is currently untracked, and is expected to be NULL.)

Validations:

  • Must be a String
data[attributes][ResponseCode]
required

code of the response

Validations:

  • Must be a String
data[attributes][ResponseCodeAVS]
required

code of the avs response (This is currently untracked, and is expected to be NULL.)

Validations:

  • Must be a String
data[attributes][InvoiceNumber]
required

number of the invoice (This is currently untracked, and is expected to be NULL.)

Validations:

  • Must be a String
data[attributes][CustomerTransactionID]
required

ID of the customer transaction (This is currently untracked, and is expected to be NULL.)

Validations:

  • Must be a String
data[attributes][UserDefinedData1]
required

user defined data 1 (This is currently untracked, and is expected to be NULL.)

Validations:

  • Must be a String
data[attributes][UserDefinedData2]
required

user defined data 2 (This is currently untracked, and is expected to be NULL.)

Validations:

  • Must be a String
data[attributes][UserDefinedData3]
required

user defined data 3 (This is currently untracked, and is expected to be NULL.)

Validations:

  • Must be a String
data[attributes][designation_information]
required

details of the designation

Validations:

  • Must be a Hash
data[attributes][designation_information][DesignationID]
required

ID of the designation

Validations:

  • Must be a number.
data[attributes][designation_information][DesignationGUID]
required

GUID of the designation. (This is currently untracked, and is expected to be NULL.)

Validations:

  • Must be a String
data[attributes][designation_information][DesignationName]
required

Name of the designation

Validations:

  • Must be a String
data[attributes][designation_information][DesignationAmount]
required

Amount of the designation

Validations:

  • Must be a number.
data[attributes][designation_information][DesignationAllocationID]
required

ID of the designation allocation

Validations:

  • Must be a number.
data[attributes][designation_information][DesignationMemo]
required

Memo of the designation

Validations:

  • Must be a String
data[attributes][designation_information][DesignationAnonymous]
required

Is the deposit designation detail anonymous? (We do not currently support anonymous transactions. This will always be false.)

Validations:

  • Must be one of: t, f, true, false, 1, 0, y, n, yes, no.

Code: 401

Description:

Unauthorized

Param name Description
errors
required

Errors returned by request

Validations:

  • Must be an Array of nested elements
errors[error]
required

Why the request failed

Validations:

  • Must be a String
errors[status]
required

HTTP response code

Validations:

  • Must be a Integer

Code: 404

Description:

Not Found

Param name Description
errors
required

Errors returned by request

Validations:

  • Must be an Array of nested elements
errors[error]
required

Why the request failed

Validations:

  • Must be a String
errors[status]
required

HTTP response code

Validations:

  • Must be a Integer

Code: 422

Description:

Unprocessable Entity

Param name Description
errors
required

Errors returned by request

Validations:

  • Must be an Array of nested elements
errors[error]
required

Why the request failed

Validations:

  • Must be a String
errors[status]
required

HTTP response code

Validations:

  • Must be a Integer

Code: 500

Description:

Internal Server Error

Param name Description
errors
required

Errors returned by request

Validations:

  • Must be an Array of nested elements
errors[error]
required

Why the request failed

Validations:

  • Must be a String
errors[status]
required

HTTP response code

Validations:

  • Must be a Integer

Errors

Code Description
404 Data source query failed
422 Invalid parameter(s)
422 Provision header missing
422 Invalid provision
422 Under maintenance
422 Incorrect host for provision
422 Establishing session failed
422 Privilege to perform the action was not found
422 Not logged in
422 Provision does not match logged in provision
422 The start date or end date is invalid
422 Start date cannot be greater than the end date
500 No connection to data source