For AI agents: the complete documentation index is at /llms.txt, and the full text of every page is at /llms-full.txt. Most pages are also available as Markdown by adding .md to the URL.

Testing Your Integration

To test your integration, send your requests to the relevant test endpoint. We also provide specific values that you can send in your request to trigger specific responses. For more information, see Triggering responses.

Note: These responses are for non-EMV test accounts.

Test endpoints

Transaction	HTTP method	Transaction identifier	Test endpoint
Running a Refund Linked to a Sale	POST	reference_id	https://api.pit.paygateway.com/transactions/creditsales/reference\_id/{reference_id}/creditreturns
creditsale_id	https://api.pit.paygateway.com/transactions/creditsales/{creditsale_id}/creditreturns
Running a Void on a Credit Sale	PUT	reference_id	https://api.pit.paygateway.com/transactions/creditsales/reference\_id/{reference_id}/voids
creditsale_id	https://api.pit.paygateway.com/transactions/creditsales/{creditsale_id}/voids
Running a Void on a Debit Sale	PUT	reference_id	https://api.pit.paygateway.com/transactions/debitsales/reference\_id/{reference_id}/voids
debitsale_id	https://api.pit.paygateway.com/transactions/debitsales/{debitsale_id}/voids
Running a Void on a Credit Refund	PUT	reference_id	https://api.pit.paygateway.com/transactions/creditreturns/reference\_id/{reference_id}/voids
creditreturn_id	https://api.pit.paygateway.com/transactions/creditreturns/{creditreturn_id}/voids
Viewing the Details of a Sale	GET	reference_id	https://api.pit.paygateway.com/transactions/card/sales/reference\_id/{reference_id}
Viewing the Details of a Credit Sale	GET	reference_id	https://api.pit.paygateway.com/transactions/creditsales/reference\_id/{reference_id}
creditsale_id	https://api.pit.paygateway.com/transactions/creditsales/{creditsale_id}
Viewing the Details of a Debit Sale	GET	reference_id	https://api.pit.paygateway.com/transactions/debitsales/reference\_id/{reference_id}
debitsale_id	https://api.pit.paygateway.com/transactions/debitsales/{debitsale_id}
Viewing the Details of a Refund	GET	reference_id	https://api.pit.paygateway.com/transactions/card/returns/reference\_id/{reference_id}
Viewing the Details of a Credit Refund	GET	reference_id	https://api.pit.paygateway.com/transactions/creditreturns/creditreturns/reference\_id/{reference_id}
creditreturn_id	https://api.pit.paygateway.com/transactions/creditreturns/{creditreturn_id}
Viewing the Details of a Debit Refund	GET	reference_id	https://api.pit.paygateway.com/transactions/debitreturns/reference\_id/{reference_id}
debitreturn_id	https://api.pit.paygateway.com/transactions/debitreturns/{debitreturn_id}

Triggering responses

You can trigger common responses, AVS responses, and CSC responses.

Triggering common responses

To trigger the scenario, send the dollar amount in your request.

Scenario	Dollar amount	Response code	Status or error message
Declined transaction	13.01	470	`"status": "Declined"` `"processor_response": "DEVELOPMENT DECLINE"`
Prompt for a voice authorization	13.02	472	`"status":"Call Issuer"`
Terminal not configured correctly	13.03	403	`"message": "Terminal not configured for requested transactions"`
Incorrectly formatted field	13.06	400	`"message": "Invalid input data."` Note: The message may include the field that is causing the error.
Merchant's batch is settling	13.07	503	`"message": "Merchant locked For settlement"`
Merchant's account is locked for database or server maintenance	13.08	503	`"message": "Service temporarily unavailable, Please try later or contact support"`
Card type not supported	13.11	400	`"message": "Card type not supported for this account."`
Failure due to one of the following: • Decline • CSC failure • Card type not supported	13.13	470	`"status": "Declined"` `"processor_response": "DEVELOPMENT TSYS ERROR"`
Server error	13.14	500	`"message": "Server error. Please contact support"`
Card type or transaction type not enabled on the merchant's account	13.15	470	`"status": "Declined"` `"processor_response": "DEVELOPMENT GPI ERROR"`
Partial approved	13.17	471	`"status": "Partially Approved"` `"processor_response": "DEVELOPMENT PARTIAL APPROVAL"` Note: The dollar amount that the customer paid is returned in the response.
Approved transaction with a card balance	13.18	201	`"status": "Approved"` `"card": {` `"balance": "6.43"` `}`

Triggering AVS responses

If there is an AVS error, our gateway returns a response code of 473. To trigger the avs_response and avs_response_description, send the postal code in your request.

avs_response	avs_response_description	Postal code	Description
`partial_match`	Match - Street Address, No Match - Postal Code	11111	Match for the street address but no match for the postal code.
`partial_match`	No Match - Street Address, Match - Postal Code (9 Digit)	22222	No match for the street address but match for the nine-digit postal code.
`partial_match`	No Match - Street Address, Match - Postal Code (5 Digit)	33333	No match for the stress address but match for the five-digit postal code.
no_match	No Match - Street Address, No Match - Postal Code	44444	No match for either the street address or postal code.
`unavailable`	Address Verification Unavailable	55555	AVS unavailable.
`full_match`	Match - Street Address, Match - Postal Code	66666	Match for the street address and postal code.
`unavailable`	Error	77777	Error. AVS unavailable.
`not_supported`	Service Not Supported	88888	AVS not supported.

Triggering CSC responses

If there is a CSC mismatch, our gateway returns a response code of 473. To trigger the card_security_response, send the CSC in your request.

card_security_response	CSC	Description
`"no match"`	111 or 1111	CSC the customer entered does not match the CSC on their card.
`"unavailable"`	222 or 2222	CSC service unavailable.
`"not_supported"`	333 or 3333	CSC service not supported.
`"unavailable"`	444 or 4444	CSC service unavailable.

Policies

Connect