Creating a FPS Token Payment

Creates a payment via Faster Payment System (FPS) using an FPS token created during QR code generation.

Request

GET /payin/v1/sites/{siteId}/sbp/qrCodes/{qrCodeUid}

Path Parameters

Parameter	Required	Type	Description
siteId	Yes	string	Merchant site identifier
qrCodeUid	Yes	string	Unique identifier of the original QR code request in the merchant’s information system: qrCodeUid value from the response to the QR code generation request

Headers

Header	Required	Type	Description
Authorization	Yes	string	API access key. Bearer [access-token]
Content-type	Yes	string	Request content. application/json
Accept	No	string	Response content. application/json

Body Parameters

Parameter	Required	Type	Description
tokenizationAccount	No	string(64)	Identifier of the customer linked to the token in the merchant’s information system
token	Yes	string	FPS token string

Request Example

FPS token payment

POST /partner/payin/v1/sites/test-01/sbp/qrCodes/adghj17d1g8/payments HTTP/1.1
Accept: application/json
Authorization: Bearer 5c4b25xx93aa435d9cb8cd17480356f9
Content-type: application/json
Host: b2b-api.qiwi.com

{
  "tokenizationAccount": "customer123",
  "token": "c5ba4a05-21c9-4a36-af7a-b709b4caa4d6"
}

Response

See also HTTP error codes

Successful Response Parameters

Parameter	Required	Type	Description
qrCodeUid	Yes	string	QR code request identifier.
qrCode	Yes	[object]	QR code parameters
amount	No	object	Operation amount
paymentPurpose	No	string(140)	Goods or service description for the customer
redirectUrl	No	string(1000)	URL to redirect the customer to after payment
tokenizationPurpose	No	string(140)	Payment token description
flags	No	array of strings	Additional API commands from the original request
payment	No	object	QR code payment information. Only for type=DYNAMIC
refunds	No	array of objects	QR code refunds information. Only for type=DYNAMIC
token	No	object	FPS payment token information

Error Parameters

Parameter	Required	Type	Description
serviceName	Yes	string	Name of the service that produced the error
errorCode	Yes	string	Error code
description	Yes	string	Error description for the merchant
userMessage	Yes	string	Error description for the customer
dateTime	Yes	string	Error date and time
traceId	Yes	string	Error Log unique ID

Response Examples

Successful responseResponse with error 4xxResponse with error 5xx

{
  "qrCodeUid": "adghj17d1g8",
  "amount": {
    "value": "100.00",
    "currency": "RUB"
  },
  "paymentPurpose": "Flower for my girlfriend",
  "redirectUrl": "http://someurl.com",
  "qrCode": {
    "type": "DYNAMIC",
    "ttl": 999,
    "status": "INIT_PAYMENT_BY_TOKEN",
    "payload": ""
  }
}

{
  "serviceName" : "payin-core",
  "errorCode" : "validation.error",
  "description" : "Validation error",
  "userMessage" : "Validation error",
  "dateTime" : "2022-03-05T11:49:59.166+03:00",
  "traceId" : "fd0e2a08c63ace83"
}

{
  "serviceName":"payin-core",
  "errorCode":"internal.error",
  "userMessage":"Internal error",
  "description":"Internal error",
  "traceId":"3fb3420ee1795dcf",
  "dateTime":"2020-02-12T21:28:01.813+03:00"
}