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.
| Name | Type | Description | Rules |
|---|---|---|---|
| host | string | (required) The CenPOS API host. Use the staging host for testing. Examples: abistaging.cenpos.net, abi.cenpos.net. | |
| merchantId | string | (required) CenPOS merchant identifier used in the transaction API path. Examples: 790010220. | |
| basicAuth | object | (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.externalmaps to CenPOSInvoice.InvoiceNumber - Authvia
transaction.idmaps to CenPOSInvoice.InvoiceNumber - Authvia
transaction.amountmaps to CenPOSInvoice.Amount - Authvia
transaction.currencymaps to CenPOSInvoice.CurrencyCode - Authvia
transaction.paymentMethod.tokenmaps to CenPOSCard.tokenId - Authvia
transaction.paymentMethod.streetAddressmaps to CenPOSCustomer.Address.StreetAddress - Authvia
transaction.paymentMethod.emailmaps to CenPOSCustomer.EmailAddress - Authvia
transaction.paymentMethod.phonemaps to CenPOSCustomer.Phone - Authvia
transaction.stepResults.AUTHORIZE.idmaps to CenPOSOriginalReferenceNumber - Authvia
transaction.references.gatewaymaps to CenPOSOriginalReferenceNumber
