Process Transactions

• Process an ACH (Electronic Check) transaction.
• Process a keyed credit card transaction.
• Process a tokenized transaction.
• You can also re-bill via a Schedule ID from a previously created recurring schedule.
• You can re-bill via a previous Transaction ID.
• If you have uploaded ACH/Card data it can be re-billed via a Vault ID.

Parameters

ACH

ACH WEB

Create an ACH WEB transaction using a plaidAccessToken.

Keyed Card

Please consider the PCI Implications of transmitting full card number data.

Token

Re-Bill by Schedule ID

Re-Bill by Transaction ID

Re-Bill by Vault ID

Credit Card Security

Transaction Fields

All amount* fields have a max value of 1,000,000. Amounts higher than 1,000,000 will cause a validation error. 

Billing Contact

Shipping Contact

Other Fields

Example Request in the "Labs Demo" account:

The example below is only sending the minimum mandatory fields.

Please note you will need to replace the API User/PW and the Application Key with your specific values.

curl -X POST -u "YOUR_USER:YOUR_PASSWORD" -H "Accept: application/json" -H "X-PJ-Application-Key: YOUR_PRODUCTION_APP_KEY" \
-d "cardNumber=4444333322221111" \
-d "cardExpMonth=01" \
-d "cardExpYear=2029" \
-d "amountBase=1901.00" \
-d "metadata[externalId]=e1ad3185-6f93-458c-9df7-3d88edb4953e" \
-d "metadata[externalData]=UNRECONCILED" \
"https://api.payjunctionlabs.com/transactions"

Example Response

API version 2023-05-16 or above required to receive the surcharge object and fields in transaction response details. See how to use API versions here.

Click here for more information regarding surcharge.

{
      "transactionId": 3601, 
      "uri": "https://api.payjunction.com/transactions/3601", 
      "terminalId" : 10000,
      "action" : "CHARGE",
      "amountBase" : "1.11",
      "amountTax" : "3.00",
      "amountShipping" : "1.00",
      "amountTip" : "2.00",
      "amountSurcharge" : "0.21",
      "amountTotal" : "7.32",
      "surcharge" : {
            "percentage" : 3.00,
            "status" : "APPLIED"
      },
      "invoiceNumber": "Invoice 5", 
      "method": "KEYED",
      "purchaseOrderNumber": "Custom PO",
      "service": "API",
      "signatureStatus": "SIGNED", 
      "status": "CAPTURE", 
      "created": "2013-11-18T22:15:32Z", 
      "lastModified": "2013-11-18T22:15:32Z", 
      "response": {
            "approved": true, 
            "code": "00", 
            "message": "Approved", 
            "processor": {
                  "authorized": true, 
                  "approvalCode": "PJ20AP", 
                  "avs": {
                        "status": "REQUESTED", 
                        "requested": "BYPASS", 
                        "match": {
                              "ZIP": true, 
                              "ADDRESS": true
                        }
                  }, 
                  "cvv": {
                        "status": "NOT_REQUESTED"
                  }
            }
      }, 
      "settlement": {
            "settled": false
      }, 
      "vault": {
            "type": "CARD", 
            "accountType": "VISA", 
            "lastFour": "1111"
      },
      "metadata" : {
            "externalId" : "e1ad3185-6f93-458c-9df7-3d88edb4953e",
            "externalData" : "UNRECONCILED"
      }, 
      "billing": {
            "firstName": "John", 
            "middleName": "J", 
            "lastName": "Doe", 
            "companyName": "PayJunction", 
            "email": "jdoe@payjunction.com", 
            "phone": "8006010230 x2", 
            "phone2": "8006010230 x2", 
            "jobTitle": "Support", 
            "identifier": "Billing Customer id", 
            "website": "http://www.payjunction.com", 
            "address": {
                  "address": "1903 State St", 
                  "city": "Santa Barbara", 
                  "state": "CA", 
                  "country": "USA", 
                  "zip": "93101"
            }
      }, 
      "shipping": {
            "firstName": "Jane", 
            "middleName": "J", 
            "lastName": "Doe", 
            "companyName": "PayJunction", 
            "email": "janedoe@payjunction.com", 
            "phone": "8006010230 x2", 
            "phone2": "8006010230 x2", 
            "jobTitle": "Support", 
            "identifier": "Shipping Customer Id", 
            "website": "https://www.payjunction.com", 
            "address": {
                  "address": "1903 State St", 
                  "city": "Santa Barbara", 
                  "state": "CA", 
                  "country": "USA", 
                  "zip": "93101"
            }
      }
}

Example Request for ACH WEB

curl -X POST https://api.payjunction.com/transactions \
-u "YOUR_USER:YOUR_PASSWORD" \
-H "Accept: application/json" \
-H "X-PJ-Application-Key: YOUR_PRODUCTION_APP_KEY" \
-d "plaidAccessToken=access-production-1f5c0cbd-1fa8-490f-ab61-1d4e57fb4ec1" \
-d "billingFirstName=first" \
-d "billingLastName=last" \
-d "amountBase=1.00"

Example Response for ACH WEB

{
  "transactionId" : 1775,
  "uri" : "https://api.payjunction.com/transactions/1775",
  "terminalId" : 11657,
  "action" : "CHARGE",
  "achType" : "WEB",
  "amountBase" : "1.00",
  "amountTotal" : "1.00",
  "method" : "PLAID",
  "service" : "API",
  "status" : "CAPTURE",
  "created" : "2022-09-08T21:28:54Z",
  "lastModified" : "2022-09-08T21:28:53Z",
  "response" : {
    "approved" : true,
    "code" : "00",
    "message" : "Approved"
  },
  "settlement" : {
    "settled" : false
  },
  "vault" : {
    "type" : "ACH",
    "accountType" : "CHECKING",
    "lastFour" : "6789",
    "achRoutingNumber" : "121000358"
  },
  "billing" : {
    "firstName" : "first",
    "lastName" : "last"
  }
}