# Payment Method Type Object

**URL:** <https://community.rapyd.net/t/payment-method-type-object/1572>\
**Category:** 🙋🏽‍♀️🙋🏽‍♂️ Ask Questions\
**Tags:** kb-article, collect-api\
**Created:** [April 15, 2022, 8:26pm UTC](https://community.rapyd.net/t/payment-method-type-object/1572 "2022-04-15T20:26:10Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Community\_Team](https://avatars.discourse-cdn.com/v4/letter/c/46a35a/32.png) [@Community\_Team](https://community.rapyd.net/u/Community_Team)\
**Post date:** [April 15, 2022, 8:26pm UTC](https://community.rapyd.net/t/payment-method-type-object/1572/1 "2022-04-15T20:26:10Z")

</div>

I’ve recently seen a few posts relating to the [Payment Method Type Object](https://docs.rapyd.net/build-with-rapyd/reference/payment-method-type-object) and finding the required fields within each payment method of a given country.

## [List Payment Methods By Country](https://docs.rapyd.net/build-with-rapyd/reference/payment-method-type-object#list-payment-methods-by-country)

Lists the full payment methods for a given country. It will include information including the payment category (ewallet, card, cash, bank transfer, bank redirect, etc), currencies, if it’s expireable, and more fields described on the reference page.

## [Get Payment Method Required Fields](https://docs.rapyd.net/build-with-rapyd/reference/payment-method-type-object#get-payment-method-required-fields)

Includes a larger response and descriptions for a specific payment method in a country. For example the response to a JCB Debit Card used in Singapore `sg_debit_jcb_card ` shows the following.

### Response

```auto
{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "8ce804ed-e6e9-4928-a3e2-58ae2a345b61"
    },
    "data": {
        "type": "sg_debit_jcb_card",
        "fields": [
            {
                "name": "name",
                "type": "string",
                "regex": "",
                "is_required": true,
                "instructions": "card holder name"
            },
            {
                "name": "number",
                "type": "string",
                "regex": "",
                "is_required": true,
                "instructions": "card number"
            },
            {
                "name": "expiration_month",
                "type": "string",
                "regex": "",
                "is_required": true,
                "instructions": "expiration month as string, 01-12"
            },
            {
                "name": "expiration_year",
                "type": "string",
                "regex": "",
                "is_required": true,
                "instructions": "expiration year in to digits as string, 18-99"
            },
            {
                "name": "cvv",
                "type": "string",
                "regex": "",
                "is_required": true,
                "instructions": "card cvv"
            }
        ],
        "payment_method_options": [
            {
                "name": "3d_required",
                "type": "boolean",
                "regex": "",
                "description": "Allows the client to determine whether the customer is required to complete 3DS authentication for the transaction",
                "is_required": false,
                "is_updatable": false
            }
        ],
        "payment_options": [
            {
                "name": "capture",
                "type": "boolean",
                "regex": "",
                "description": "Determines when the payment is processed for capture.",
                "is_required": false,
                "is_updatable": false
            },
            {
                "name": "complete_payment_url",
                "type": "string",
                "regex": "",
                "description": "the complete_payment_url field must be filled in.",
                "is_required": true,
                "is_updatable": false
            },
            {
                "name": "error_payment_url",
                "type": "string",
                "regex": "",
                "description": "the error_payment_url field must be filled in.",
                "is_required": true,
                "is_updatable": false
            },
            {
                "name": "statement_descriptor",
                "type": "string",
                "regex": "/^[a-zA-Z0-9]{0,22}/",
                "description": "A text description suitable for a customer's payment statement. Limited to 22 characters.",
                "is_required": false,
                "is_updatable": false
            }
        ],
        "minimum_expiration_seconds": 0,
        "maximum_expiration_seconds": 604800
    }
}

```

You can see a number of fields are required for a payment including the cardholders name, number, exp month and year, the cvv, a URL for when the payment is complete and one for when there is an error. This is marked by `"is_required": true,`

These will be required when passing the information via API or adding the card to the customer.