Affinipay
Affinipay is a direct merchant payment processor connection
Supported Features
- Credit Card Transactions
Adding Merchant Credentials
To establish an API connection with Affinipay for a merchant who already has a relationship with them, you will need to provide the following credentials:
- Affinipay Account ID
- Affinipay API Secret Key
Please note that the Affinipay account ID will determine if the account can perform transactions in US or Canadian currency.
You may upload this via the Preczn Dashboard, merchant import or by updating the merchant connection via Update Connection Details endpoint. The values needed in the request would map as follows:
PATCH /v1/merchants/{merchantId}/connections/AffiniPay
{
"mid":"{affinipay_account_id}",
"secret":"{affinipay_secret_key}"
}
Affinipay Custom Fields
Affinipay supports the concept of Custom Fields in their data object. Custom Fields will display on the Affinipay Payment Receipts.
Preczn maps the following transaction fields to the Affinipay Custom Fields. When data is included in the Preczn transaction request for these fields, it will be displayed on the Affinipay Payment Receipt:
Preczn Transaction Field | Affinipay Custom Field |
---|---|
invoice | Invoice |
description | Notes |
Additionally, keys and values that are included in Preczn Metadata object will also be included in the Affinipay Custom Fields and render on the invoice.
As an example:
Preczn MetaData Key / Value | Affinipay Custom Field Key /Value |
---|---|
"ContactID": "XYZ123" | "ContactID": "XYZ123" |
Implementation Configuration and Best Practices
Every connection has nuisance and may require configuration directly with connection in order to ensure transactions follow smoothly.
Affinipay Account Configuration
To ensure recurring transactions can proceed smoothly, configure your Affinipay merchant account settings as follows:
- Make sure the "required_payment_fields" do not include
CVV
, so it's not required for each transaction. This will ensure that recurring transactions that do not have CVV will process smoothly. - Set the "cvv_policy" to
Optional
to enable CVV validation when it is available, such as for primary transactions.
Additionally, please note that for assistance in making these recommended changes to your account settings, it's advisable to contact Affinipay support or reach out to your Affinipay representative.
Updated 4 months ago