Payments

Returns previous payment response data if available by a PaymentGuid or an EpfSessionId

get
Query parameters
paymentGuidstring · uuidOptional
epfSessionIdstring · uuidOptional
Header parameters
AccessTokenstringRequired

access token

Responses
chevron-right
200

Returns payment response data

application/json
get
/api/paymentResponse

Make a payment

post
Header parameters
AccessTokenstringRequired

access token

Body
ProcessorGuidstring · nullableOptional

optional for Non-Profit transactions like donations but required if For-Profit API Partner - Identifies Processor being used by an API Partner

CharityIdstring · nullableOptional

optional - Valid CharityId from Charity Search

OrganizationGuidstring · nullableOptional

internal use - Valid Panorama Organization Guid

IntegrationSourcestring · nullableOptional

internal use - Identifies integrated Product

CardNumstring · nullableOptional

optional - Valid Credit card number - required for non-Wallet transaction

CardTypestring · nullableOptional

optional - "American Express", "Mastercard", "Visa", "Discover", "Diners Club" - will be set internally based on cardNum

ExpMonthstring · max: 2 · nullableOptional

optional - example: "01" for January - required for non-Wallet transaction

ExpYearstring · max: 2 · nullableOptional

optional - example: "29" for 2029 - required for non-Wallet transaction

CVNumstring · max: 4 · nullableOptional

optional - valid CVV - please provide for CVV checks

NameOnCardstring · max: 25Required

required - Name on Card

Zipstring · max: 10 · nullableOptional

optional - please provide for best interchange and avs checks - US, CA, AU formats are validated (example formats - US: 12345 or 12345-1234, CA: A1A 1A1, AU: 3000

Streetstring · max: 50 · nullableOptional

optional - please provide for best interchange and avs checks

Emailstring · email · max: 100Required

required - valid contact email

Citystring · max: 50 · nullableOptional

optional - please provide for best interchange and avs checks

Statestring · max: 50 · nullableOptional

optional - 2 char US state code, 3 char may be used for other non-US

Countrystring · max: 2 · nullableOptional

optional - 2 char country code

Currencystring · max: 3 · nullableOptional

optional - 3 char currency code - Example for US - "USD", for CA - "CAD"

ExternalConstituentIdstring · max: 200 · nullableOptional

optional - ConstituentId per Product

FirstNamestring · max: 50 · nullableOptional

optional - billing First Name

LastNamestring · max: 50 · nullableOptional

optional - billing Last Name

BillingDescriptorstring · max: 22 · nullableOptional

optional - descriptor to show on bank statement

IpAddressstring · max: 40Required

required - client ip address where transaction originates

ExternalEventIdstring · max: 10 · nullableOptional

optional - Event Id per Product

ExternalEventGuidstring · nullableOptional

optional - Event Guid per Product

ExternalEventNamestring · max: 500 · nullableOptional

optional - Event Name per Product

ShippingFeestring · max: 7 · nullableOptional

optional fee for shipping that will be added to the total amount

TaxableBenefitstring · max: 7 · nullableOptional

optional - If part of the donation being passed in is taxable, include that amount here. No calculations are performed using this value, it is simply a placeholder to be used for your own reporting; all commission and credit card fees still apply as normal.

TranIdstring · max: 100 · nullableOptional

optional - system unique id (max 100 chars) for Dup Checking per Integration Source transaction (where integration source has DupCheckEnabled) that will be checked against successfully processed prior TranIds for Duplicates

EpfSessionIdstring · nullableOptional

internal use - FrontStream unique Embedded Payment Form Session Id if available

PaymentMethodTypeIdstring · nullableOptional

required to be set if GooglePay (8) or Apple Pay (9) - possible values - 8 - GOOGLEPAY, 9 - APPLEPAY

ExternalPaymentDatastring · nullableOptional

required for Wallet transactions

Surchargestring · max: 7 · nullableOptional

optional - calculated surcharge amount that will be added to the total amount

Tokenizeboolean · nullableOptional

optional - set to true to tokenize card at time of purchase

Responses
post
/api/payment

Make a payment by credit card or ACH check token

post
Header parameters
AccessTokenstringRequired

access token

Body
ProcessorGuidstring · nullableOptional

optional for Non-Profit transactions like donations but required if For-Profit API Partner - Identifies Processor being used by an API Partner

CharityIdstring · nullableOptional

optional - Valid CharityId from Charity Search

OrganizationGuidstring · nullableOptional

internal use - Valid Panorama Organization Guid

IntegrationSourcestring · nullableOptional

internal use - Identifies integrated Product

TokenGuidstring · nullableOptional

optional if using ExternalCardToken or ExternalCheckToken instead of TokenGuid - Valid Token Guid from a Tokenized card through Payment API

ExternalCardTokenstring · max: 200 · nullableOptional

internal use

ExternalCheckTokenstring · max: 200 · nullableOptional

internal use

TranIdstring · max: 100 · nullableOptional

optional - system unique id (max 100 chars) for Dup Checking per Integration Source transaction (where integration source has DupCheckEnabled) that will be checked against successfully processed prior TranIds for Duplicates

EpfSessionIdstring · nullableOptional

internal use - FrontStream unique Embedded Payment Form Session Id if available

BillingDescriptorstring · max: 22 · nullableOptional

optional - descriptor to show on bank statement

IpAddressstring · max: 40 · nullableOptional

client ip address where transaction originates

ShippingFeestring · max: 7 · nullableOptional

optional fee for shipping that will be added to the total amount

TaxableBenefitstring · max: 7 · nullableOptional

optional - If part of the donation being passed in is taxable, include that amount here. No calculations are performed using this value, it is simply a placeholder to be used for your own reporting; all commission and credit card fees still apply as normal.

Zipstring · max: 10 · nullableOptional

optional to override zip created during token creation - US, CA, AU formats are validated (example formats - US: 12345 or 12345-1234, CA: A1A 1A1, AU: 3000

Streetstring · max: 50 · nullableOptional

optional to override street created during token creation

Citystring · max: 50 · nullableOptional

optional to override city created during token creation

Statestring · max: 50 · nullableOptional

optional to override state created during token creation

Countrystring · max: 2 · nullableOptional

optional to override country created during token creation

Currencystring · max: 3 · nullableOptional

optional to override currency created during token creation

ExternalConstituentIdstring · max: 200 · nullableOptional

optional - ConstituentId per Product

ExternalEventIdstring · max: 10 · nullableOptional

optional - Event Id per Product

ExternalEventGuidstring · nullableOptional

optional - Event Guid per Product

ExternalEventNamestring · max: 500 · nullableOptional

optional - Event Name per Product

Surchargestring · max: 7 · nullableOptional

optional - calculated surcharge amount

Responses
post
/api/paymentToken

Verify a credit card

post
Header parameters
AccessTokenstringRequired

access token

Body
ProcessorGuidstring · nullableOptional

required if API Partner - Identifies Processor being used by an API Partner

IntegrationSourcestring · nullableOptional

internal use - Identifies integrated Product

CardNumstringRequired

required - Valid Credit card number

ExpMonthstring · min: 2 · max: 2Required

required - example: "01" for January

ExpYearstring · min: 2 · max: 2Required

required - example: "29" for 2029

CVNumstring · max: 4 · nullableOptional

optional - valid CVV - please provide for CVV checks

NameOnCardstring · max: 25Required

required - Name on Card

Emailstring · email · max: 100Required

required - valid contact email

Zipstring · max: 10 · nullableOptional

optional - please provide for best interchange and avs checks - US, CA, AU formats are validated (example formats - US: 12345 or 12345-1234, CA: A1A 1A1, AU: 3000

Streetstring · max: 50Required

required - please provide for best interchange and avs checks

Citystring · max: 50Required

required - please provide for best interchange and avs checks

Statestring · max: 50 · nullableOptional

optional - 2 char US state code, 3 char may be used for other non-US

Countrystring · max: 2Required

required - 2 char country code

FirstNamestring · max: 50 · nullableOptional

optional - billing First Name

LastNamestring · max: 50 · nullableOptional

optional - billing Last Name

Currencystring · max: 3 · nullableOptional

optional - 3 char currency code - Example for US - "USD", for CA - "CAD"

IpAddressstring · max: 40Required

required - client ip address where transaction originates

Responses
chevron-right
200

Success

application/json
post
/api/verifyCard

Make an ach payment

post
Header parameters
AccessTokenstringRequired

access token

Body
ProcessorGuidstring · nullableOptional

optional for Non-Profit transactions like donations but required if For-Profit API Partner - Identifies Processor being used by an API Partner

CharityIdstring · nullableOptional

optional - Valid CharityId from Charity Search

OrganizationGuidstring · nullableOptional

internal use - Valid Panorama Organization Guid

IntegrationSourcestring · nullableOptional

internal use - Identifies integrated Product

CheckRoutingNumberstring · max: 9Required

required - Valid Check Bank Routing Number

CheckAccountNumberstring · max: 20Required

required - Valid Check Account Number

CheckNumberstring · max: 10 · nullableOptional

optional - Valid Check Number

CheckAccountTypeIdstringRequired

required for Check ACH transactions - possible values - 1 - Checking, 2 - Savings

CheckTypeIdstringRequired

required for Check ACH transactions - possible values - 1 - Personal, 2 - Corporate, 3 - Government

NameOnCheckstring · max: 25Required

required - Name on ACH Check Account

Zipstring · max: 10 · nullableOptional

optional - US, CA, AU formats are validated (example formats - US: 12345 or 12345-1234, CA: A1A 1A1, AU: 3000

Streetstring · max: 50 · nullableOptional

optional - billing street

Emailstring · email · max: 100Required

required - valid contact email

Citystring · max: 50 · nullableOptional

optional - billing city

Statestring · max: 50Required

required - 2 char US state code, 3 char may be used for other non-US

Countrystring · max: 2 · nullableOptional

optional - 2 char country code

Currencystring · max: 3 · nullableOptional

optional - 3 char currency code - Example for US - "USD", for CA - "CAD"

ExternalConstituentIdstring · max: 200 · nullableOptional

optional - ConstituentId per Product

FirstNamestring · max: 50 · nullableOptional

optional - billing First Name

LastNamestring · max: 50 · nullableOptional

optional - billing Last Name

BillingDescriptorstring · max: 22 · nullableOptional

optional - descriptor to show on bank statement

IpAddressstring · max: 40Required

required - client ip address where transaction originates

ExternalEventIdstring · max: 10 · nullableOptional

optional - Event Id per Product

ExternalEventGuidstring · nullableOptional

optional - Event Guid per Product

ExternalEventNamestring · max: 500 · nullableOptional

optional - Event Name per Product

ShippingFeestring · max: 7 · nullableOptional

optional fee for shipping that will be added to the total amount

TaxableBenefitstring · max: 7 · nullableOptional

optional - If part of the donation being passed in is taxable, include that amount here. No calculations are performed using this value, it is simply a placeholder to be used for your own reporting; all commission and credit card fees still apply as normal.

TranIdstring · max: 100 · nullableOptional

optional - system unique id (max 100 chars) for Dup Checking per Integration Source transaction (where integration source has DupCheckEnabled) that will be checked against successfully processed prior TranIds for Duplicates

EpfSessionIdstring · nullableOptional

internal use - FrontStream unique Embedded Payment Form Session Id if available

PaymentMethodTypeIdstring · nullableOptional

optional - if used please set to 7 for ACH

Tokenizeboolean · nullableOptional

optional - set to true to tokenize check at time of purchase

Responses
post
/api/paymentAch

Last updated