Charge Codes or Pricing

The charge codes are also referred to as pricing. In the API document there are two APIs related to pricing:

• Get Pricing

• Create / Update Pricing

 An ISV can have multiple charge codes, the charge codes must be set up and available for ISVs to use during merchant creation. ISVs can set one of the charge code as default.

When a merchant is created the default charge code is associated to the merchant. If for any reason, the ISV want another existing charge code to be associated with the merchant, they can perform this action by using Create / Update Pricing API.

The major limitation is that, the ISV needs to select (via ISV Portal) or update (via API) the correct charge code, before the merchant downloads their product order form and submits the application. If it needs to be changed after that, the system doesn’t support the process. The change must be performed by contacting:

• Risk team (risk.monitoring@theaccessgroup.com) or

• Support team (evolvesupport@theaccessgroup.com) .

When the charge code is changed after the application submission, a new product order must be generated and sent to merchant for acceptance. Once agreed by the merchant the new product order will be updated against the merchant record. These are all manual tasks performed by risk or support team.

Get Pricing

The current pricing or charge code associated with the merchant can be obtained by running Get Pricing endpoint. This will return the charge code for the merchant, during merchant creation.

{
    "chargeCode": "CC040",
    "reason": "Default charge code for ISV at merchant creation",
    "selectedBy": "Pay360:apikey_11012312@pay360evolve.com",
    "selectedAt": "2024-01-02T16:05:55.379Z",
    "changes": [
        {
            "chargeCode": "CC040",
            "reason": "Default charge code for ISV at merchant creation",
            "selectedBy": "Pay360:apikey_11012312@pay360evolve.com",
            "selectedAt": "2024-01-02T16:05:55.379Z"
        }
    ]
}

Create / Update Pricing

The Create / Update Pricing API allows you to change the current pricing or charge code associated with the merchant, provided:

• The charge code is set up and available for the ISV.

• The merchant has not submitted their application.

{
"chargeCode": "CC005",
"merchantId": "{{merchantId}}",
"reason": "Change requested by ISV"
}

Once the application is submitted, if we try to run the Create / Update Pricing API the following error is shown.

{
    "title": "Merchant and Applcation status is not suitable for Pricing.",
    "status": 400,
    "detail": "Merchant and Applcation status is not suitable for Pricing.",
    "instance": "/demo/pf-api-gateway/apiGateway/merchant/merchants/11014434/pricing/changes",
    "code": "merchant.application.status.not.allowed",
    "traceId": "e90eed3ad5d067df",
    "timestamp": "2024-01-09T18:16:42.434198Z"
}