CenPOS

How to enable CenPOS Token on a merchant.

CenPOS token payments support authorize, capture, load, void, refund, and load_refund using a vaulted card tokenId from the CenPOS tokens API, through the same REST transaction endpoint as credit card operations.

Features

Refund A token payment processed with CenPOS can be / according to its status.
Payment Authorization Payments can be authorized by customers using Token.
Payment Capture Payment authorizations made using Token payment methods can be captured. This step happens automatically with CHARGE transactions.

Resources

Configuration

Obtain API credentials (username and password) and your merchant ID from CenPOS. Tokenize a card first via the CenPOS tokenize product, then run token payments with the returned tokenId. Use the staging host (abistaging.cenpos.net) for testing.

This table describes the required or possible attributes needed to configure a merchant product for this type.

NameTypeDescriptionRules
hoststring(required) The CenPOS API host. Use the staging host for testing. Examples: abistaging.cenpos.net, abi.cenpos.net.
merchantIdstring(required) CenPOS merchant identifier used in the transaction API path. Examples: 790010220.
basicAuthobject(required) Username and password for Basic authentication. Examples: [object Object].

Enabling this Product

Using create-merchant-product API you can add a new product to your merchant record. Below is an example configuration for the payload of that request.

{
  "line": "payments",
  "product": "token",
  "provider": "cenpos",
  "config": {
    "host": "abi.cenpos.net",
    "merchantId": "790010220",
    "basicAuth": {
        "username": "integration",
        "password": "your_password_here"
    }
},
  
}

Data Mapping

The following bullet points outline the mapping of data fields between the Authvia platform and the CenPOS system, detailing the correspondence of specific attributes for seamless data integration.

  • Authvia transaction.references.external maps to CenPOS Invoice.InvoiceNumber
  • Authvia transaction.id maps to CenPOS Invoice.InvoiceNumber
  • Authvia transaction.amount maps to CenPOS Invoice.Amount
  • Authvia transaction.currency maps to CenPOS Invoice.CurrencyCode
  • Authvia transaction.paymentMethod.token maps to CenPOS Card.tokenId
  • Authvia transaction.paymentMethod.streetAddress maps to CenPOS Customer.Address.StreetAddress
  • Authvia transaction.paymentMethod.email maps to CenPOS Customer.EmailAddress
  • Authvia transaction.paymentMethod.phone maps to CenPOS Customer.Phone
  • Authvia transaction.stepResults.AUTHORIZE.id maps to CenPOS OriginalReferenceNumber
  • Authvia transaction.references.gateway maps to CenPOS OriginalReferenceNumber