Retreive Issuer

POST 
/source/issuer

Retreive Issuer

Request

application/json

Body

required

sourceobjectrequired

Simplified payment source object for which to retreive the issuer.

oneOf

CreditCardSource

type string

Possible values: [creditcard]

number PanNumber (string)

Possible values: Value must match regular expression ^\d{16,19}$

The card number as a string without any separators.

DevicePaymentSource

type string

Possible values: [applepay]

token string

Encrypted Apple Pay token to be processed.

metadataobject
A set of key-value pairs where both key and value are strings. Metadata allows you to add more information to the object that will be returned later on in responses and webhook messages. Metadata is searchable using the Payment List API.
property name* string

Responses

201

Successful operation

application/json

Schema

Schema

issuer_name stringrequired

Name of the card issuing bank. This name is inferred based on the card BIN or IIN.

issuer_country stringrequired

Origin country of the card issuer. A two-letter ISO 3166 code.

issuer_card_type IssuerCardType (string)required

Possible values: [debit, credit, charge_card, unspecified]

issuer_card_category IssuerCardCategory (string)required

Indicates the card category or product type, e.g., Platinum, Signature, etc.

This field is a human readable text and does not have a defined set of values.

Example (from schema)

{
  "issuer_name": "Moyasar Sandbox Bank.",
  "issuer_country": "SA",
  "issuer_card_type": "debit",
  "issuer_card_category": "SIGNATURE"
}

400

Business Error or validation error.

application/json

Schema

Schema

type string

Contains the error type

message string

Human readable error message for the error

errors object

Contains string-array pair representing a field and list of validation errors.

Example (from schema)

{
  "type": "invalid_request",
  "message": null,
  "errors": {
    "foo": "this is returned for validation errors only"
  }
}

401

Invalid authorization credentials

application/json

Schema

Schema

type string

Possible values: [authentication_error]

message string

Possible values: [Invalid authorization credentials]

errors object

Example (from schema)

{
  "type": "authentication_error",
  "message": "Invalid authorization credentials",
  "errors": null
}

403

Invalid authorization credentials

application/json

Schema

Schema

type string

Possible values: [api_error]

message string

Possible values: [User not authorized]

errors object

Example (from schema)

{
  "type": "api_error",
  "message": "User not authorized",
  "errors": null
}

Loading...