Integrate with PFAC and Non-Bank Networks for Argentina

Integration with Payment REST API using regionalExtras for Argentina through Non-Bank Networks and Payment Facilitators (PFACs)

Latin America

This document outlines the integration of the required fields within the regionalExtras object for Argentina, necessary to process payments through Non-Bank Networks and Payment Facilitators (PFACs or Payment Service Providers).

Non-Bank Networks

To process a payment through a Non-Bank Network using a REST integration, you must include the following fields in the payment request, inside the argentina object, which is part of the regionalExtras object:

Parameters	Type	Format	Description
argentina	object		Indicates fields specific to the country, as follows:
`businessID`	string	8-digit	Required for Non-Bank Networks payments. Indicates the number assigned to the collection agent that is part of the Visa program.
`dynamicMerchantName`	string	Recommended format: [extrabankName]*[subMerchantName]	Required for Non-Bank Networks payments. Indicates the name or description of the collection agent.

Sample request

The following is an example of the regionalExtras object in the context of a payment request:

"regionalExtras":{  
     "argentina":{  
          "businessID": "00000025",  
          "dynamicMerchantName": "Fiserv_Clover"  
}  
}

The payment response does not reference the fields specified for Non-Bank Networks.

Payment Facilitators (PFACs)

To process a payment through a PFAC using a REST integration, the client merchant’s data
must be included in the payment request. To do this, add the subMerchant object within
the argentina object, which is included in the regionalExtras object.

Properties of the subMerchant object:

Parameters	Type	Format	Description
subMerchant	object		Required for PFAC payments (Payment Facilitators). Defined with the following properties:
`merchantID`	string		Unique identifier of the client merchant capturing the transaction.
`mcc`	string	4-digit	Merchant Category Code. - 6051 for Mastercard transactions. - 4829 for Visa transactions.
`legalName`	string		Legal name or business name of the client merchant.
address	object		Indicates the legal address of the client merchant, with the following properties:
`address 1`	string		Main street address.
`zip`	string		ZIP or postal code.
`city`	string		City.
`country`	string	3-charater	Country.
document	object		Indicates the CUIT (tax ID) details of the client merchant, with the following properties:
`type`	string		Indicates the document type. Use SINGLE_TAX_IDENTIFICATION for CUIT. Note: CUIT (Clave Única de Identificación Tributaria) is the unique tax identification code in Argentina, used to identify individuals, businesses, and entities for all tax-related matters.
`number`	string	11-digit	Indicates the CUIT number.

Sample request

The following is an example of the regionalExtras object in the context of a payment request:

"regionalExtras": {
  "argentina": {
    "currency": "ARS",
    "subMerchant": {
      "merchantID": "00000012",
      "mcc": "4816",
      "legalName": "Clover SubMerchant",
      "address": {
        "address1": "Calle 123",
        "zip": "1234",
        "city": "CABA",
        "country": "ARG"
      },
      "document": {
        "type": "SINGLE_TAX_IDENTIFICATION",
        "number": "12345678912"
      }
    }
  }
}

The payment response does not reference the fields specified for PFAC.

Updated about 3 hours ago