Request for the list of bindings of a certain bank card (getBindingsByCardOrId.do)

Provided that a store has corresponding permissions, it can get the list of all bindings that relate to a certain bank card. This can be done by a card number or by a known binding identifier. The method used for getting the list of bindings of a bank card is getBindingsByCardOrId.do. The response returns all the bindings available to the merchant in accordance with their settings.

In this document, the following data type conventions are used when describing request and response parameters:

A<n> – a sequence of Latin letters of length <n>;
A..<n> – a sequence of Latin letters with a length not exceeding <n>;
N<n> – a sequence of digits of length <n>;
N..<n> – a sequence of digits with a length not exceeding <n>;
AN<n> – a sequence of Latin letters and numbers of fixed length <n>;
AN.. <n> – a sequence of Latin letters and numbers with a length not exceeding <n>;
ANS<n> – a sequence of Latin letters, numbers and characters of fixed length <n>
ANS.. <n> – a sequence of Latin letters, numbers and characters with a length not exceeding <n>;
UTC – date and time, in this case: the date must be passed without specifying the time zone, Moscow time, for the SOAP protocol, the standard encoding xs: dateTime is used.

Request parameters

Name	Type	Mandatory	Description
`userName`	AN..30	Yes	Login of the service account of the merchant.
`password`	AN..30	Yes	Merchant's service account password.
`pan`	N12…19	Required if `bindingId` is not indicated.	Payment card number.
`bindingId`	AN..255	Required if `pan` is not specified.	The identifier of the previously created binding. Can only be used if the merchant has permission to work with bindings. If this parameter is passed in the given request, it means that: 1. The given order can be paid only using a binding; 2. The payer will be redirected to the payment page on which only entering CVC is required.
`showExpired`	boolean	No	This parameter defines the necessity to display bindings with expired card validity periods. The available values are: true, false. By default the parameter has the false value.

Response parameters

Name	Type	Mandatory	Description
`errorCode`	ANS..3	Yes	Error code. Can be missing if the result has not caused an error.
`errorMessage`	AN..512	Yes	Error description in the language passed in the `language` parameter in the request.
`bindings` element (contains blocks that consist of the bindingId, maskedPan, expiryDate and clientId parameters):
`bindingId`	AN..255	No	The identifier of the previously created binding. Can only be used if the merchant has permission to work with bindings. If this parameter is passed in the given request, it means that: 1. The given order can be paid only using a binding; 2. The payer will be redirected to the payment page on which only entering CVC is required.
`maskedPan`	N..19	No	Masked number of the card that has been used for the payment.
`expiryDate`	N6	No	Expiry date of the card in the format YYYYMM. This parameter is to be specified only after the order has been paid.
`clientId`	ANS..255	No	Identifier of the Customer in the Store system. This parameter is used for the binding functionality. May be present if the store is allowed to create bindings. Specifying this parameter when processing payments with the use of bindings is mandatory. Otherwise, a payment will be unsuccessful.

Error codes

Error code	Error text
0	The request has been processed without system errors.
1	Search parameters `[pan]` or `[bindingId]` are not set.
2	The information is not found.
5	Access denied.
5	The user must change the password.
7	System error.

Examples

Request example

userName=login&password=password&pan=4111111111111111

Response example

{"errorCode":"0","errorMessage":"Success","bindings":[{"bindingId":"0b8edeb2-8380-4092-bf7e-1e1a78f2b15e","maskedPan":"411111**1111","expiryDate":"201912","clientId":"12"},{"bindingId":"6a8c0738-cc88-4200-acf6-afc264d66cb0","maskedPan":"411111**1111","expiryDate":"201912","clientId":"666"},{"bindingId":"97a70989-c1fb-49f7-8a42-27c19dc160dw","maskedPan":"411111**1111","expiryDate":"201512","clientId":"666"}]}