telegram api method · layer 229 · #2d03522f

payments.sendPaymentForm

usable by users

Send compiled payment form

definition

payments.sendPaymentForm#2d03522f flags:# form_id:long invoice:InputInvoice requested_info_id:flags.0?string shipping_option_id:flags.1?string credentials:InputPaymentCredentials tip_amount:flags.2?long = payments.PaymentResult;

parameters

nametypedescription
flags#Flags, see TL conditional fields
form_idlongForm ID
invoiceInputInvoiceInvoice
requested_info_idflags.0?stringID of saved and validated order info
shipping_option_idflags.1?stringChosen shipping option ID
credentialsInputPaymentCredentialsPayment credentials
tip_amountflags.2?longTip, in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).

returns

payments.PaymentResult

errors (7)

codeerrordescription
400BUSINESS_CONNECTION_NOT_ALLOWEDThis method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection.
400FORM_UNSUPPORTEDPlease update your client.
400INVOICE_INVALIDThe specified invoice is invalid.
400MESSAGE_ID_INVALIDThe provided message id is invalid.
400PAYMENT_CREDENTIALS_INVALIDThe specified payment credentials are invalid.
400PEER_ID_INVALIDThe provided peer id is invalid.
400TMP_PASSWORD_INVALIDThe passed tmp_password is invalid.

history

present in layers 65–229 · constructor id changed 2×

idlayers
#2b8879b365–126
#30c3bc9d127–142
#2d03522f143–229