Tokenization

Tokenize a credit card

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

CardNumstring · max: 30Required

Valid Credit card number

CardTypestring · max: 20 · nullableOptional

optional (max: 20) - "American Express", "Mastercard", "Visa", "Discover", "Diners Club" - will be set internally based on cardNum

ExpMonthstring · min: 2 · max: 2Required

example: "01" for January - required

ExpYearstring · min: 2 · max: 2Required

example: "29" for 2029 - required

CVNumstring · max: 4 · nullableOptional

optional (max: 4) - 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 (max: 10) - 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

Currencystring · max: 3 · nullableOptional

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

ExternalConstituentIdstring · max: 200 · nullableOptional

optional (max: 200) - ConstituentId per Product

FirstNamestring · max: 50 · nullableOptional

optional (max: 50) - billing First Name

LastNamestring · max: 50 · nullableOptional

optional (max: 50) - billing Last Name

IpAddressstring · max: 40 · nullableOptional

client ip address (max: 40) where transaction originates

Responses
chevron-right
201

Returns the newly created token

application/json
SuccessfulbooleanOptional

This is "true" tokenization process was successful, and "false" if unsuccessful.

Messagestring · nullableOptional

Get Token response message

ProcessorMessagestring · nullableOptional

Get Token Processor response message

TransactionIdstring · nullableOptional

Not currently used and may be null

TokenGuidstring · uuidOptional

The unique GUID associated with the credit card or bank token you created that is used with the api/paymentToken endpoint

ExternalCardTokenstring · nullableOptional

ExternalCardToken if available to return - represents 3rd party gateway card token

ExternalCheckTokenstring · nullableOptional

ExternalCheckToken if available to return - represents 3rd party gateway check token

ExternalCustomerIdstring · nullableOptional

ExternalCustomerId if available to return - represents 3rd party gateway customer id tied to gateway token

ResponseCodestring · nullableOptional

Response Code - Successful = "OK" or "0", any other response code unsuccessful

post
/api/tokenize

Tokenize ACH/check account

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 Guid 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 - formats - US: Enter 9-digits, CA: Enter 9-digits (Format: 0YYYXXXXX: A mandatory leading zero. YYY: The 3-digit institution number. XXXXX: The 5-digit transit number), AU: Enter 6-digits - BSB Number (Bank State Branch) without hyphen

CheckAccountNumberstring · max: 20Required

required - Valid Check Account Number - formats - US: Enter 8-12 digits, CA: Enter 7-12 digits, AU: Enter 3-9 digits

CheckNumberstring · max: 10 · nullableOptional

optional (max: 10) - Valid Check Number

CheckAccountTypeIdstringRequired

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

CheckTypeIdstringRequired

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

NameOnCheckstring · max: 25Required

required - Name on ACH Check Account

Emailstring · email · max: 100Required

required - valid contact email

Zipstring · max: 10 · nullableOptional

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

Streetstring · max: 50Required

optional (max: 50) - billing street

Citystring · max: 50Required

optional (max: 50) - billing city

Statestring · max: 50 · nullableOptional

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

Countrystring · max: 2Required

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 (max: 200) - ConstituentId per Product

FirstNamestring · max: 50 · nullableOptional

optional (max: 50) - billing First Name

LastNamestring · max: 50 · nullableOptional

optional (max: 50) - billing Last Name

IpAddressstring · max: 40 · nullableOptional

client ip address (max: 40) where transaction originates

Responses
chevron-right
201

Returns the newly created token

application/json
SuccessfulbooleanOptional

This is "true" tokenization process was successful, and "false" if unsuccessful.

Messagestring · nullableOptional

Get Token response message

ProcessorMessagestring · nullableOptional

Get Token Processor response message

TransactionIdstring · nullableOptional

Not currently used and may be null

TokenGuidstring · uuidOptional

The unique GUID associated with the credit card or bank token you created that is used with the api/paymentToken endpoint

ExternalCardTokenstring · nullableOptional

ExternalCardToken if available to return - represents 3rd party gateway card token

ExternalCheckTokenstring · nullableOptional

ExternalCheckToken if available to return - represents 3rd party gateway check token

ExternalCustomerIdstring · nullableOptional

ExternalCustomerId if available to return - represents 3rd party gateway customer id tied to gateway token

ResponseCodestring · nullableOptional

Response Code - Successful = "OK" or "0", any other response code unsuccessful

post
/api/tokenizeAch

Last updated