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 FieldAffinipay Custom Field
invoiceInvoice
descriptionNotes

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 / ValueAffinipay 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.