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

Make a payment

post

Header parameters

AccessTokenstringRequired

access token

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

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

201

Returns the newly created payment

application/json

400

If it fails to create a payment

application/json

post

/api/payment

HTTPcURLJavaScriptPython

POST /api/payment HTTP/1.1
AccessToken: text
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 1441

{
  "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",
  "EpfSessionId": "text",
  "Transactions": [
    {
      "TransactionSourceGroupId": "text",
      "Amount": "text",
      "PayFee": true,
      "CommissionRateOverride": "text",
      "CardProcessingFeeOverride": "text",
      "ExternalLineId": "text",
      "Tip": "text",
      "Tax": "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",
  "Surcharge": "text",
  "Tokenize": true
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

{
  "Successful": true,
  "Message": "text",
  "ProcessorMessage": "text",
  "AuthCode": "text",
  "TransactionId": "text",
  "PaymentGuid": "123e4567-e89b-12d3-a456-426614174000",
  "PaymentId": 1,
  "ResponseCode": "text",
  "PaymentResult": 1,
  "ProcessStatus": 1,
  "TotalAmount": 1,
  "TotalSurcharge": 1,
  "AVSStreetStatus": "text",
  "AVSZipStatus": "text",
  "AVSResponse": "text",
  "CVVResponse": "text",
  "ExternalCardToken": "text",
  "ExternalCheckToken": "text",
  "ExternalCustomerId": "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,
      "Tax": 1
    }
  ],
  "OrganizationGuid": "123e4567-e89b-12d3-a456-426614174000",
  "ProcessorGuid": "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",
  "PaymentMethodTypeId": 1,
  "IsSurchargeEligible": true,
  "CheckAccountNum": "text",
  "TranId": "text",
  "EpfSessionId": "text",
  "PaymentDate": "2026-01-27T17:51:49.899Z"
}

Payment Example

Take a look at how you might call this method:

C#

// Some code

Postman