Mastercard Bill Payment Processing {#payments-mc-bill-pay-intro}
================================================================

This section describes how to request an authorization for a Mastercard Bill Payment. See [Mastercard Bill Payments](/docs/vas/en-us/payments/developer/ctv/rest/payments/payments-intro/payments-features-intro/payments-mc-bill-pay.md "") for a description of and requirements for processing Mastercard Bill Payments.

Field Specific to this Use Case
-------------------------------

Include this field with a standard authorization request when processing a Mastercard Bill Payment:

processingInformation.authorizationOptions.billPaymentType
:
Set the value to indicate the type of bill that the cardholder is paying.

Requirements {#payments-mc-bill-pay-intro_section_mmj_t4s_5xb}
--------------------------------------------------------------

Sign up with Mastercard to participate in their bill payment program.

Endpoint {#payments-mc-bill-pay-intro_d7e16}
--------------------------------------------

**Production:** `POST ``https://api.visaacceptance.com``/pts/v2/payments`{#payments-mc-bill-pay-intro_d7e25}  
**Test:** `POST ``https://apitest.visaacceptance.com``/pts/v2/payments`{#payments-mc-bill-pay-intro_d7e35}

Required Fields for Authorizing a Mastercard Bill Payment {#payments-mc-bill-pay-all-fields}
============================================================================================

Use these required fields to authorize a Mastercard bill payment.

> IMPORTANT  
> When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see [Relaxed Requirements for Address Data and Expiration Date in a Payment](/docs/vas/en-us/payments/developer/ctv/rest/payments/payments-relax-reqs.md "").

orderInformation.amountDetails.currency
:

orderInformation.amountDetails.totalAmount
:

orderInformation.billTo.address1
:

orderInformation.billTo.administrativeArea
:

orderInformation.billTo.country
:

orderInformation.billTo.email
:

orderInformation.billTo.firstName
:

orderInformation.billTo.lastName
:

orderInformation.billTo.locality
:

orderInformation.billTo.postalCode
:

paymentInformation.card.expirationMonth
:

paymentInformation.card.expirationYear
:

paymentInformation.card.number
:

processingInformation.authorizationOptions.billPaymentType
:
Set the value to indicate the type of bill that the cardholder is paying.
{#payments-mc-bill-pay-all-fields_dl_ocl_rxj_5xb}

REST Example: Authorizing a Mastercard Bill Payment {#payments-mc-bill-pay-ex-rest}
===================================================================================

Request

```
{
    "orderInformation": {
        "billTo": {
            "country": "BR",
            "lastName": "Doe",
            "firstName": "John",
            "address1": "Av Pres Juscelino Kubistchek 1909",
            "address2": "",
            "postalCode": "04543907",
            "locality": "Sao Paulo",
            "administrativeArea": "SP",
            "email": "john.doe@company.com"
        },
        "amountDetails": {
            "totalAmount": "100.00",
            "currency": "BRL"
        }
    },
    "paymentInformation": {
        "card": {
            "expirationMonth": "12",
            "expirationYear": "2031",
            "number": "555555555555xxxx",
            "securityCode": "123",
            "type": "002"
        }
    },
    "processingInformation": {
        "authorizationOptions": {
            "billPaymentType": "001"
        }
    }
}
```

Response to a Successful Request

```
{
  "_links" : {
    "authReversal" : {
      "method" : "POST",
      "href" : "/pts/v2/payments/6863356803746501803955/reversals"
    },
    "self" : {
      "method" : "GET",
      "href" : "/pts/v2/payments/6863356803746501803955"
    },
    "capture" : {
      "method" : "POST",
      "href" : "/pts/v2/payments/6863356803746501803955/captures"
    }
  },
  "clientReferenceInformation" : {
    "code" : "1686335680358"
  },
  "id" : "6863356803746501803955",
  "orderInformation" : {
    "amountDetails" : {
      "authorizedAmount" : "100.00",
      "currency" : "brl"
    }
  },
  "paymentAccountInformation" : {
    "card" : {
      "type" : "002"
    }
  },
  "paymentInformation" : {
    "tokenizedCard" : {
      "type" : "002"
    },
    "card" : {
      "type" : "002"
    }
  },
  "processorInformation" : {
    "approvalCode" : "010012",
    "networkTransactionId" : "999010012",
    "transactionId" : "72b2900a9f316142b627a21031b48b0c259f08ffba0004172a04450c5d212345",
    "responseCode" : "400",
    "avs" : {
      "code" : "2"
    }
  },
  "reconciliationId" : "NHRRGOVtUxkb",
  "status" : "AUTHORIZED",
  "submitTimeUtc" : "2023-06-09T18:34:40Z"
}
```