taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

confirm-peer-pull-debit.rst (990B)

      1 .. ts:op:: confirmPeerPullDebit
      2 
      3   Accept an incoming peer pull payment (i.e. pay the other party),
      4   after reviewing the request with :ts:op:`preparePeerPullDebit`.
      5 
      6   **Request:**
      7 
      8   The request body must be a `ConfirmPeerPullDebitRequest` object.
      9 
     10   **Response:**
     11 
     12   On success, the result is an `AcceptPeerPullPaymentResponse`
     13   object.  Confirmation is idempotent: confirming a transaction that
     14   already left the review state returns the same ``transactionId``.
     15 
     16   **Side effects:**
     17 
     18   Pays the requested peer pull payment to the other wallet over the
     19   network.
     20 
     21   **Expected errors:**
     22 
     23   The caller can handle the following errors inline:
     24   ``WALLET_PEER_PULL_PAYMENT_INSUFFICIENT_BALANCE``,
     25   ``WALLET_TRANSACTION_NOT_FOUND``.
     26 
     27 .. ts:def:: ConfirmPeerPullDebitRequest
     28 
     29   interface ConfirmPeerPullDebitRequest {
     30     transactionId: TransactionIdStr;
     31   }
     32 
     33 .. ts:def:: AcceptPeerPullPaymentResponse
     34 
     35   interface AcceptPeerPullPaymentResponse {
     36     transactionId: TransactionIdStr;
     37   }