1. REST Services Manager API for Billing and Revenue Management
  2. Tasks
  3. Payment Method Management

Get Payment Methods

get

/paymentMethod

Gets the payment methods that match the query criteria.

Request

Query Parameters
  • The Business Identifier Code of a bank, to get bankAccountDebit payment methods.
    Example:
    AAAABBCCDD
  • The account number, to get a bankAccountDebit payment method.
    Example:
    1234567890
  • The name of a bank, to get bankAccountDebit payment methods.
    Example:
    My Bank
  • The card number, to get a bankCard payment method.
    Example:
    5.111111111111118E15
  • The name on the card, to get bankCard payment methods. You can use bankCard.nameOnCard.like= to get partial matches.
    Example:
    Use bankCard.nameOnCard=John%20Smith to get an exact match, or use bankCard.nameOnCard.like=John%25 to get all bank cards with names that start with John.
  • The type of bank card, to get bankCard payment methods. The only valid value for BRM is CREDIT.
    Example:
    CREDIT
  • The list of comma-separated fields to return in the response.
    Example:
    fields=account,bankCard.nameOnCard
  • The maximum number of results to return.
    Example:
    Use limit=10 to return the first 10 results only.
  • The number of results to offset the response by.
    Example:
    Use offset=10 to return results 10 and higher.
  • The ID of a related party to get payment methods for.
    Example:
    0.0.0.1+-account+107117
  • The type of related party to get payment methods for.
  • The type of payment method to get.
    Allowed Values: [ "tokenizedCard", "bankAccountDebit", "bankCard" ]

There's no request body for this operation.

Back to Top

Response

Supported Media Types

200 Response

The payment methods were returned successfully.
Headers
Body ()
Root Schema : schema
Type: array
Show Source
Nested Schema : PaymentMethodType
Type: object
A payment method.
Show Source
Nested Schema : account
Type: array
An account that owns or can use the payment method.
Show Source
Nested Schema : details
Type: object
The payment method's details, which differ based on the '@type' property.
Nested Schema : relatedParty
Type: array
The related party that owns the payment method.
Show Source
Nested Schema : TimePeriodType
Type: object
A period of time.
Show Source
Nested Schema : AccountRefType
Type: object
An account reference.
Show Source
Nested Schema : RelatedPartyRefType
Type: object
A related party.
Show Source

400 Response

Invalid Token

401 Response

Unauthorized

403 Response

Forbidden

405 Response

Method not Allowed

500 Response

Internal Server Error
Back to Top

Examples

The following example shows how to get a list of no more than two bankAccountDebit payment methods at the My Bank bank by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL. 

curl -X GET 'http://host:port/brm/paymentMethods/version/paymentMethod?type=bankAccountDebit&limit=2'

Example of the Response Body

The following example shows the contents of the response body in JSON format. Because of the query criteria, only two debit accounts are shown. 

[
{
    "id": "0.0.0.1+-payinfo-dd+240947",
    "href": "http://host:port/brm/paymentMethods/version/paymentMethod/0.0.0.1+-payinfo-dd+240947",
    "name": "Mary Robbin's Direct Debit Account",
    "description": null,
    "validFor": null,
    "account": [
        {
            "id": "0.0.0.1+-account+244543",
            "href": null,
            "description": "Mary's Primary Account",
            "name": "Mary Robbins",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": null,
            "@referredType": null
        }
    ],
    "preferred": true,
    "relatedParty": null,
    "@type": "bankAccountDebit",
    "authorizationCode": null,
    "status": null,
    "statusDate": null,
    "details": {
        "accountNumber": "12341234123412341",
        "accountNumberType": "Savings",
        "BIC": "111122334",
        "owner": "Mary Robbins",
        "bank": "My Bank"
    }
},
{
    "id": "0.0.0.1+-payinfo-dd+249648",
    "href": "http://host:port/brm/paymentMethods/version/paymentMethod/0.0.0.1+-payinfo-dd+249648",
    "name": "Grace Wang's Direct Debit Account",
    "description": null,
    "validFor": null,
    "account": [
        {
            "id": "0.0.0.1+-account+104221",
            "href": null,
            "description": "Grace's Primary Account",
            "name": "Grace Wang",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": null,
            "@referredType": null
        }
    ],
    "preferred": true,
    "relatedParty": null,
    "@type": "bankAccountDebit",
    "authorizationCode": null,
    "status": null,
    "statusDate": null,
    "details": {
        "accountNumber": "12345678901236491",
        "accountNumberType": "Savings",
        "BIC": "111122334",
        "owner": "Grace Wang",
        "bank": "My Bank"
    }
}
]
Back to Top