Transaction object

Learn about the Payment object and the attributes it has.

Transaction object

Transactions represent changes in balance within one account. The details (attributes) contained within one transaction define the Transaction object.

AttributeDescription
actionPayment type
amountPayment amount
codePayment code according to which the payment has been created
currencyPayment currency
descriptionPayment code description
descriptorName of the company/website that deducted money
modePayment mode
orderIdUnique order identifier
statusPayment status
transactionIdUnique payment identifier
urlLink to the ACS in the issuer domain

Source (payment method) object

AttributeDescription
brandCard brand
bicBank identifier code
methodPayment method
numberCard number
paymentAccountIdUnique encrypted account identifier

Consumer object

AttributeDescription
cityCustomer's city name
countryCustomer's country name
emailCustomer's email address
externalIdUnique customer identifier within the merchant's system
firstNameCustomer's first name
idUnique customer identifier within Gateway's system
lastNameCustomer's last name
phoneCustomer's phone number
stateCustomer's state name
zipZip code

Subscription object

AttributeDescription
cancelDateSubscription cancel date
cycleSequential number of recurring payments in a subscription
idSubscription ID
renewalDateSubscription renewal date
statusSubscription Status

Metadata object

Used for storing additional structured information associated with the payment.

Payment object example

{
  "payment": {
    "code": "0",
    "description": "APPROVED",
    "action": "charge",
    "url": "https://google.com/oijhflsfs9",
    "mode": "sale",
    "status": "success",
    "amount": 9.99,
    "currency": "USD",
    "orderId": "235324530",
    "transactionId": "12345",
    "descriptor": "centrohelp.com",
    "source": {
      "method": "card",
      "number": "402400****6348",
      "brand": "visa",
      "paymentAccountId": "d86bdcbb-c369-46d9-a9d0-9c5010e3bfdb"
    }
  },
  "consumer": {
    "id": "string",
    "externalId": "14253ms92m0as",
    "email": "[email protected]",
    "firstName": "string",
    "lastName": "string",
    "phone": "+1987353539",
    "country": "string",
    "state": "string",
    "city": "string",
    "zip": "36101"
  },
  "subscription": {
    "id": "string",
    "status": "active",
    "renewalDate": "2020-04-17 13:43:02",
    "cancelDate": "2020-11-17 13:43:02",
    "cycle": 0
  },
  "metadata": {
    "foo": "bar"
  }
}