Follow

PUT /transactions/{transactionId}

Update a Transaction

Send the parameters that you want to update. All other parameters will remain the same

Note: Transaction Fields cannot be updated once the transaction has settled.

Parameters

Transaction Fields

 
required name format description
  status HOLD | CAPTURE | VOID Transaction Status affects whether or not the transaction will be settled. More Details
  achType PPD | CCD | TEL Only for ACH transactions
PPD - Consumer Account
CCD - Business Account
TEL - Sales made via inbound phone call
  amountBase Money,
Format: X.XX
Ex: 1000.00 or $1,000.00
Base amount to charge.
  amountShipping Money,
Format: X.XX
Ex: 1000.00 or $1,000.00
If you want to track separate shipping amounts use this parameter.
  amountTip Money,
Format: X.XX
Ex: 1000.00 or $1,000.00
If you want to add a tip to the transaction then use this parameter.
  amountReject Money,
Format: X.XX
Ex: 1000.00 or $1,000.00
If you are re-billing a rejected ACH transaction and you want to charge a reject fee then use this parameter.
  amountTax Money,
Format: X.XX
Ex: 1000.00 or $1,000.00
If you are billing tax then use this parameter.
  amountSurcharge Money,
Format: X.XX
Ex: 1000.00 or $1,000.00
If you want to add a surcharge to the transaction then use this parameter.

Billing Contact

required name format description
  billingIdentifier Max Length 64 Billing customer id. If you have your own customer ID you want to associate with the transaction.
  billingFirstName Max Length 16 Billing first name.
  billingLastName Max Length 32 Billing last name.
  billingCompanyName Max Length 64 Billing company name.
  billingJobTitle Max Length 32 Billing job title. Ex: President
  billingPhone Max Length 24 Billing phone number.
  billingPhone2 Max Length 24 Billing alternate phone number.
  billingAddress Max Length 128 Billing street address.
  billingCity Max Length 32 Billing city.
  billingState Max Length 32 Billing state.
  billingZip Max Length 16 Billing zip.
  billingCountry Max Length 32 Billing country.
  billingEmail Max Length 128 Billing email.
  billingWebsite Max Length 128 Billing website.

Shipping Contact

required name format description
  shippingIdentifier Max Length 64 Shipping customer id. If you have your own customer ID you want to associate with the transaction.
  shippingFirstName Max Length 16 Shipping first name.
  shippingMiddleName Max Length 32 Shipping middle name.
  shippingLastName Max Length 32 Shipping last name.
  shippingCompanyName Max Length 64 Shipping company name.
  shippingJobTitle Max Length 32 Shipping job title. Ex: President
  shippingPhone Max Length 24 Shipping phone number
  shippingPhone2 Max Length 24 Shipping alternate phone number.
  shippingAddress Max Length 128 Shipping street address.
  shippingCity Max Length 32 Shipping city.
  shippingState Max Length 32 Shipping state
  shippingZip Max Length 16 Shipping zip.
  shippingCountry Max Length 32 Shipping country.
  shippingEmail Shipping email address. Shipping email address.
  shippingWebsite Max Length 128 Shipping website.

Other Fields

required name format description
  invoiceNumber Max Length 32 Invoice number. If would would like to mark this transaction with your own invoice number for accounting.
  purchaseOrderNumber Max Length 32 Purchase order number. If you would like to mark this transaction with your own PO for accounting.

Example Response

{
      "transactionId": 3601, 
      "uri": "https://api.payjunction.com/transactions/3601", 
      "terminalId": 1, 
      "action": "CHARGE", 
      "amountBase": "1.00", 
      "amountTax": "1.00", 
      "amountShipping": "1.00", 
      "amountTip": "1.00", 
      "amountSurcharge": "1.00", 
      "amountTotal": "5.00", 
      "invoiceNumber": "Invoice 5", 
      "purchaseOrderNumber": "Custom PO",
      "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"
      }, 
      "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"
            }
      }
}