package mobile.kin.payment.v1
Get desktop application:
View/edit binary Protocol Buffers messages
******************************************************************************** Feature Payment service The feature payment service is responsible for processing KIN payments for all chat experiences Processing include verifying payment JWT, storing transaction records and/or calling other services Examples include: in-group admin tipping, p2p user tipping (future), cover charge (future) ********************************************************************************
Retrieves a PayToUser JWT that is used to initiate user-to-user payment transaction on the KIN marketplace.
message
feature_payment_service.proto:36optional sender_user_jid = 1
User jid of the sending user. Will be one-way hashed before being included in the JWT.
optional recipient_jid = 2
User or alias jid of the receiving user, depending on the chat type (public group payments will use alias jids). Will be one-way hashed before being included in the JWT.
optional payment_info = 3
Contains information about the payment being requested, including feature and amount.
message
feature_payment_service.proto:48GetPayToUserJwtResponse.Result result = 1
GetPayToUserJwtResponse.RejectionReason rejection_reason = 2
optional pay_to_user_offer_jwt = 3
The generated PayToUser JWT. The JWT payload is defined in the Kin ecosystem API: https://github.com/kinecosystem/ecosystem-api#paytouser-payload.
Verifies and processes a payment confirmation JWT originating from the Kin SDK. A record of the transaction will be stored during processing.
message
feature_payment_service.proto:76optional sender_user_jid = 1
User jid of the sending user. Used to verify and process the payment_confirmation_jwt.
optional recipient_jid = 2
User or alias jid of the receiving user, depending on the chat type (public group payments will use alias jids). Used to verify and process the payment_confirmation_jwt.
optional payment_info = 3
Contains information about the payment being requested, including feature and amount. Used to verify and process the payment_confirmation_jwt.
optional payment_confirmation_jwt = 4
PaymentConfirmation JWT (https://github.com/kinecosystem/ecosystem-api#paymentconfirmation-payload) originating from the Kin SDK. The information in the JWT will be verified against the other information contained in the request. The stellar blockchain transaction ID in the JWT will be used to store the transaction record.
message
feature_payment_service.proto:94ProcessPaymentToUserResponse.Result result = 1
ProcessPaymentToUserResponse.RejectionReason rejection_reason = 2
Retrieves limits that affect a user's ability to spend Kin
optional user_jid = 1
The user whose limits we're retrieving
common.kin.payment.v1.Feature feature = 2
The feature to retrieve limits for
GetUserSpendTransactionLimitsResponse.Result result = 1
GetUserSpendTransactionLimitsResponse.RejectionReason rejection_reason = 2
optional transaction_amount_limits = 3
Limits related to the amount of a single transaction
Retrieves limits that affect a user's ability to receive Kin for multiple users
repeated user_jids = 1
The bare or alias jids of the users whose limits are being retrieved
common.kin.payment.v1.Feature feature = 2
The feature to retrieve limits for
GetUsersReceiveTransactionLimitsResponse.Result result = 1
GetUsersReceiveTransactionLimitsResponse.RejectionReason rejection_reason = 2
repeated user_transaction_limits = 3
Sanity bound. There may be situations where the client needs to retrieve limits for more than this number of users, but in those cases the client should batch the users.
Used in:
UNKNOWN = 0
INVALID_FEATURE = 1
The requested feature is not valid
INVALID_ALIAS_JID = 2
The alias jid is either not registered or is not valid for the requested feature
MAX_SPEND_AMOUNT_EXCEEDED = 3
Transaction amount exceeds the max amount for a single spend transaction
DAILY_SPEND_LIMIT_EXCEEDED = 4
Transaction amount + previous cumulative spend transactions exceed the sender's daily spend quota
DAILY_RECEIVE_LIMIT_EXCEEDED = 5
The recipient doesn't have any remaining daily spend quota
Used in:
OK = 0
REJECTED = 1
Used in:
UNKNOWN = 0
INVALID_FEATURE = 1
The requested feature is not valid
Used in:
OK = 0
REJECTED = 1
Used in:
UNKNOWN = 0
INVALID_FEATURE = 1
The requested feature is not valid
INVALID_ALIAS_JID = 2
One or more of the requested alias jids are either not registered or are not valid for the requested feature
Used in:
OK = 0
REJECTED = 1
Used in:
UNKNOWN = 0
INVALID_FEATURE = 1
The requested feature is not valid
INVALID_JWT = 2
The JWT is corrupt or not valid
REQUEST_JWT_MISMATCH = 3
The information provided in the request does not match the information in the JWT
Used in:
OK = 0
REJECTED = 1
Used in: ,
optional max_amount = 1
The max amount of a transaction
optional daily_limit = 2
The daily transaction quota of a user
optional remaining_daily_limit = 3
The remaining daily transaction quota of a user
Used in:
optional user_jid = 1
optional transaction_amount_limits = 2
Limits related to the transaction Kin amount