On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/payments/developer/barclays/rest/payments/payments-processing-mastercard-intro/payments-pow-processing-intro.md)  
Filter  
FILTER BY TAG

Mastercard Payment of Winnings Processing {#payments-pow-processing-intro}
==========================================================================

This section describes how to process a credit for Mastercard Payment of Winnings.

> WARNING
> Payment of Winnings (POW) is prohibited in some countries and restricted to specific card types in the countries where it is allowed. ` Cybersource ` does not perform BIN checks on these transactions to verify that the customer is permitted to receive payouts in their region for their card type. ` Cybersource ` recommends that merchants perform their own BIN checks or verify with ` Barclays `.

Endpoint {#payments-pow-processing-intro_d14e169}
-------------------------------------------------

**Production:** `POST ``https://api.cybersource.com``/pts/v2/credits/`{#payments-pow-processing-intro_d14e178}  
**Test:** `POST ``https://apitest.cybersource.com``/pts/v2/credits/`{#payments-pow-processing-intro_d14e188}

Related Information
-------------------

* See [Mastercard Payment of Winnings Stand-Alone Credits](/docs/cybs/en-us/payments/developer/barclays/rest/payments/payments-intro/payments-features-intro/payments-pow-intro.md "") for a description of and requirements for processing a Mastercard Payment of Winnings.

Required Fields for Processing a Mastercard Payment of Winnings {#payments-processing-basic-pow-req-fields}
===========================================================================================================

Use these required fields to process a Mastercard Payment of Winnings.

> 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 Payment Transactions](/docs/cybs/en-us/payments/developer/barclays/rest/payments/payments-relax-reqs.md "").

[clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "")
:

[orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "")
:

[orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "")
:

[orderInformation.billTo.address1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-address1.md "")
:

[orderInformation.billTo.administrativeArea](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-admin-area.md "")
:

[orderInformation.billTo.country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-company-country.md "")
:

[orderInformation.billTo.email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-email.md "")
:

[orderInformation.billTo.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-first-name.md "")
:

[orderInformation.billTo.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-last-name.md "")
:

[orderInformation.billTo.locality](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-locality.md "")
:

[orderInformation.billTo.phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-phone-num.md "")
:

[orderInformation.billTo.postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "")
:

[paymentInformation.card.expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-mo.md "")
:

[paymentInformation.card.expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-year.md "")
:

[paymentInformation.card.number](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-number.md "")
:

[paymentInformation.card.type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-type-a.md "")
:
For a list of possible values, see [Card Types](/docs/cybs/en-us/payments/developer/barclays/rest/payments/payments-intro/payments-intro-cards-types.md "").

[processingInformation.refundOptions.reason](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-refund-ops-reason.md "")
:
Set the value to `pow`.

Related Information
-------------------

* [API field reference guide for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md "")

Optional Fields for Processing a Mastercard Payment of Winnings {#payments-processing-basic-pow-opt-fields}
===========================================================================================================

Include these optional fields to process a Mastercard Payment of Winnings if you need to provide a merchant surname, override the default settings for the merchant first name or location, or override the default settings for the customer first and last names.

[recipientInformation.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/recipient-info-aa/recipient-info-first-name.md "")
:
By default, this field is set to the value in the orderInformation.billTo.firstName field. Include this field in the request message if you want to override the default setting.

[recipientInformation.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/recipient-info-aa/recipient-info-last-name.md "")
:
By default, this field is set to the value in the orderInformation.billTo.lastName field. Include this field in the request message if you want to override the default setting.

[senderInformation.account.number](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/sender-info-aa/sender-info-account-num.md "")
:
Include this field if you need to provide a payment card account number or bank account number for your merchant account.

[senderInformation.account.fundsSource](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/sender-info-aa/sender-info-account-funds-source.md "")
:
Possible values for processing a Mastercard Payment of Winnings:

    * `00`: Other
    * `01`: RTN + bank account
    * `02`: International bank account number (IBAN)
    * `03`: Card account
    * `04`: Email
    * `05`: Phone number
    * `06`: Bank account number (BAN) + bank identification code (BIC)
    * `07`: Wallet ID
    * `08`: Social network ID

[senderInformation.address1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/sender-info-aa/sender-info-address1.md "")
:
Merchant street address. By default, this field is set to the corresponding value in your configuration on the `Cybersource` platform.

[senderInformation.countryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/sender-info-aa/sender-info-country-code.md "")
:
Merchant country code. By default, this field is set to the corresponding value in your configuration on the `Cybersource` platform.

[senderInformation.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/sender-info-aa/sender-info-first-name.md "")
:
Merchant first name. By default, this field is set to the corresponding value in your configuration on the `Cybersource` platform.

[senderInformation.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/sender-info-aa/sender-info-last-name.md "")
:
Include this field if you need to provide a last name for your merchant account.

[senderInformation.locality](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/sender-info-aa/sender-info-locality.md "")
:
Merchant city. By default, this field is set to the corresponding value in your configuration on the `Cybersource` platform.

Related Information
-------------------

* [API field reference guide for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md "")

REST Example: Processing a Mastercard Payment of Winnings {#payments-processing-basic-pow-ex-rest}
==================================================================================================

Request

```
{
  "clientReferenceInformation": {
    "code": "12345678"
  },
  "processingInformation": {
    "refundOptions": { 
      "reason": "pow"
    }
  },
  "recipientInformation": {
    "lastName": "Joseph",
    "firstName": "Bloggs"
  },
  "senderInformation": {
    "firstName": "The",
    "lastName": "Company",
    "address1": "1 High Street",
    "locality": "Belfast",
    "countryCode": "GBR",
    "account": {
      "number": "12345678901xxxx",
      "fundsSource": "01"
    }
  },
  "paymentInformation": {
    "card": {
      "number": "555555555555xxxx",
      "expirationMonth": "01",
      "expirationYear": "2025",
      "type": "002"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "200",
      "currency": "GBP"
    },
    "billTo": {
      "firstName": "Joe",
      "lastName": "Bloggs",
      "address1": "1 The Street",
      "locality": "City",
      "administrativeArea": "County",
      "postalCode": "AB12CD",
      "country": "GB",
      "email": "jb@example.com",
      "phoneNumber": "07000000000"
    }
  }
}
```

Response to a Successful Request

```
{{
  "_links" : {
    "void" : {
      "method" : "POST",
      "href" : "/pts/v2/credits/6922294815876855103092/voids"
    },
    "self" : {
      "method" : "GET",
      "href" : "/pts/v2/credits/6922294815876855103092"
    }
  },
  "clientReferenceInformation" : {
    "code" : "12345678"
  },
  "creditAmountDetails" : {
    "currency" : "GBP",
    "creditAmount" : "200.00"
  },
  "id" : "6922294815876855103092",
  "orderInformation" : {
    "amountDetails" : {
      "currency" : "GBP"
    }
  },
  "paymentAccountInformation" : {
    "card" : {
      "type" : "002"
    }
  },
  "paymentInformation" : {
    "tokenizedCard" : {
      "type" : "002"
    },
    "card" : {
      "type" : "002"
    }
  },
  "reconciliationId" : "5003323433",
  "status" : "PENDING",
  "submitTimeUtc" : "2023-08-16T23:44:41Z"
}
```

RELATED TO THIS PAGE