Selecting payment methods in addition to 'filtering out' payment methods

Tazapay now allows you to specify payment methods for a transaction in addition to filtering out payment methods. Previously, you could only filter out payment methods for a transaction using the 'filter' field in the /v1/checkout and /v1/session/payment endpoints.

This new field 'payment_methods' takes the same input as the 'filter' field, that is, it takes an array of strings as the input. The string keyword can be known using the Collection Methods metadata endpoint.

NOTE: In case both the fields are present in the request body, the 'payment_methods' field will take precedence.

Example:

The payment methods available for a buyer from Australia are the following for an invoice of USD 500.

  • New Payment Platform
  • Bank Redirect
  • Card
  • Local Bank Transfer
  • Wire Transfer

If you only want to have Card and New Payment Platform as payment methods for the transaction, you can go either of the two ways below:

Specifying Payment Methods using 'payment methods' field

This is the payload which you can pass in the POST /v1/checkout API.

{
    "buyer": {
        "email": "[email protected]",
        "country": "AU",
        "ind_bus_type": "Business",
        "business_name": "Legends Private Limited"
    },
    "fee_paid_by": "buyer",
    "fee_percentage": 100,
    "invoice_currency": "USD",
    "invoice_amount": 500,
    "txn_description": "Game Cards",
    "payment_methods": ["Card","New Payment Platform"]
}

Filtering out Payment Methods using 'filter' field

This is the payload which you can pass in the POST /v1/checkout API.

{
    "buyer": {
        "email": "[email protected]",
        "country": "AU",
        "ind_bus_type": "Business",
        "business_name": "Legends Private Limited"
    },
    "fee_paid_by": "buyer",
    "fee_percentage": 100,
    "invoice_currency": "USD",
    "invoice_amount": 500,
    "txn_description": "Game Cards",
    "filter": ["Bank Redirect","Local Bank Transfer","Wire Transfer"]
}