Payment using a payment token

The client can pay for an order without entering their bank card details. In this case, the payment is made using a payment token. To connect this payment method, please contact our support service.

The issuance of a payment token is described in the article «Internet Acquiring» → «Payment Token».

The client can pay for an order with a payment token only on the site for which the token was issued. To make the token work on other sites, contact customer support.

Payment using a payment token can be implemented in a single-step or two-step scenario. In the payment creation request, you need to specify the following parameters:

Parameter	Value
paymentMethod.type	TOKEN
paymentMethod.paymentToken	The string value of the payment token
customer.account	The identifier of the client for whom the token was issued

Payment Creation RequestPayment Creation Response

PUT /partner/payin/v1/sites/test-02/payments/1815 HTTP/1.1
Accept: application/json
Authorization: Bearer 7uc4b25xx93xxx5d9cb8cd17480356f9
Content-type: application/json
Host: b2b-api.qiwi.com

{
    "amount": {
        "currency": "RUB",
        "value": 2000.00
    },
    "paymentMethod" : {
        "type": "TOKEN",
        "paymentToken" : "66aebf5f-098e-4e36-922a-a4107b349a96"
    },
    "customer": {
        "account": "token324"
    }
}

HTTP/1.1 200 OK
Content-Type: application/json

{
    coming soon
}

Request and response are provided as an example: for the current format and list of parameters, refer to the API documentation.

To make a direct debit using a payment token, you need to provide additional parameters in the payment creation request. See the article «Internet Acquiring» → «Partner Form Payment» → «Bank Card Payment» → «Direct Debits».