Payment
To try a test and directly interact with the API endpoint click "Test It" and use an embedded API client to send requests with custom headers and variables, then see the live response; essentially letting you test this API directly within this page. When testing please use our Demo URL: https://demo-payments.frontstream.com/api/payment
access token
required - Identifies Processor being used by an API Partner
optional - Valid CharityId from Charity Search
internal use - Valid Panorama Organization Guid
internal use - Identifies integrated Product – PAN, Firstgiving, Artez, BFG, and can also be an Api Partner
optional - Valid Credit card number - required for non-Wallet transaction
optional - "American Express", "Mastercard", "Visa", "Discover", "Diners Club"
optional - example: "01" for January - required for non-Wallet transaction
optional - example: "29" for 2029 - required for non-Wallet transaction
optional - valid CVV
required
optional - US and CA formats are validated (example formats - US: 12345 or 12345-1234 CA: K1V 2
optional
required - valid contact email
optional
optional - 2 char state code
optional - 2 char country code
optional - 3 char currency code - Example for US - "USD", for CA - "CAD"
optional - ConstituentId per Product
optional
optional
optional - descriptor to show on Credit Card statement
required - client ip address where transaction originates
optional - Event Id per Product
optional - Event Guid per Product
optional - Event Name per Product
optional fee for shipping that will be added to the total amount
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.
optional for Dup Checking - unique id (max 100 chars) per Integration Source transaction (where integration source has DupCheckEnabled) that will be checked against successfully processed prior TranIds for Duplicates
required for Wallet transactions - possible values - 1 - AMEX, 2 - MASTERCARD, 3 - VISA, 4 - DISCOVER, 5 - DINERSCLUB, 6 - JCB, 7 - ACH, 8 - GOOGLEPAY, 9 - APPLEPAY, 10 - STRIPE
required for Wallet transactions
POST /api/payment HTTP/1.1
Host:
AccessToken: text
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 1371
{
"ProcessorGuid": "text",
"CharityId": "text",
"OrganizationGuid": "text",
"IntegrationSource": "text",
"CardNum": "text",
"CardType": "text",
"ExpMonth": "text",
"ExpYear": "text",
"CVNum": "text",
"NameOnCard": "text",
"Zip": "text",
"Street": "text",
"Email": "[email protected]",
"City": "text",
"State": "text",
"Country": "text",
"Currency": "text",
"ExternalConstituentId": "text",
"FirstName": "text",
"LastName": "text",
"BillingDescriptor": "text",
"IpAddress": "text",
"ExternalEventId": "text",
"ExternalEventGuid": "text",
"ExternalEventName": "text",
"ShippingFee": "text",
"TaxableBenefit": "text",
"TranId": "text",
"Transactions": [
{
"TransactionSourceGroupId": "text",
"Amount": "text",
"PayFee": true,
"CommissionRateOverride": "text",
"CardProcessingFeeOverride": "text",
"ExternalLineId": "text",
"Tip": "text"
}
],
"AFShieldAdditional": {
"ProductDescription": "text",
"ProductItem": "text",
"ProductType": "text",
"ProductQuantity": "text",
"SessionId": "text",
"BillToPhoneNumber": "text",
"ShippingAddressStreet1": "text",
"ShippingAddressStreet2": "text",
"ShippingAddressCountry": "text",
"ShippingAddressCity": "text",
"ShippingAddressEmail": "[email protected]",
"ShippingAddressName": "text",
"ShippingAddressZip": "text",
"ShippingAddressState": "text",
"ShipToPhoneNumber": "text",
"ShipToPremiseForUK": "text",
"ShipToStreetForUK": "text",
"BillToPremiseForUK": "text",
"BillToStreetForUK": "text"
},
"PaymentMethodTypeId": "text",
"ExternalPaymentData": "text"
}
{
"Successful": true,
"Message": "text",
"ProcessorMessage": "text",
"TransactionId": "text",
"PaymentGuid": "123e4567-e89b-12d3-a456-426614174000",
"PaymentId": 1,
"ResponseCode": "text",
"PaymentResult": 1,
"ProcessStatus": 1,
"TotalAmount": 1,
"AVSStreetStatus": "text",
"AVSZipStatus": "text",
"CVVResponse": "text",
"TokenGuid": "123e4567-e89b-12d3-a456-426614174000",
"TransactionFees": [
{
"TransactionSourceGroupId": "text",
"PaymentAmount": 1,
"CardFeeRate": 1,
"CardFeeAmount": 1,
"CardTypeFeeAmount": 1,
"TotalCommissionRate": 1,
"TotalCommissionAmount": 1,
"PartnerCommissionRate": 1,
"PartnerCommissionAmount": 1,
"FsCommissionRate": 1,
"FsCommissionAmount": 1,
"TotalFees": 1,
"MaxOverridePartnerCommissionRate": 1,
"MinOverridePartnerCommissionRate": 1,
"PerTransFee": 1,
"Tip": 1,
"CardFeeOnFeeAmount": 1
}
],
"OrganizationGuid": "123e4567-e89b-12d3-a456-426614174000",
"FirstName": "text",
"LastName": "text",
"EmailAddress": "text",
"PostalCode": "text",
"AddressLine1": "text",
"City": "text",
"ProvinceCode": "text",
"CountryCode": "text",
"CardNum": "text",
"CardType": "text",
"ExpMonth": "text",
"ExpYear": "text",
"Currency": "text"
}
Payment Example
Take a look at how you might call this method:
// Some code
Last updated