taler-docs

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

post-admin-add-kycauth.rst (1349B)

      1 .. http:post:: /admin/add-kycauth
      2 
      3   Simulate a transfer from a customer to the exchange.  This API is *not*
      4   idempotent since it's only used in testing.
      5 
      6   **Request:**
      7 
      8   .. ts:def:: AddKycauthRequest
      9 
     10     interface AddKycauthRequest {
     11       // Amount to transfer.
     12       amount: Amount;
     13 
     14       // Account public key that is included in the wire transfer details
     15       // to associate this key with the originating bank account.
     16       account_pub: EddsaPublicKey;
     17 
     18       // Account (as full payto URI) that makes the wire transfer to the exchange.
     19       // Usually this account must be created by the test harness before this
     20       // API is used. An exception is the "fakebank", where any debit account
     21       // can be specified, as it is automatically created.
     22       debit_account: string;
     23     }
     24 
     25   **Response:**
     26 
     27   :http:statuscode:`200 OK`:
     28     The request has been correctly handled, so the funds have been transferred to
     29     the recipient's account.  The body is a `AddIncomingResponse`.
     30   :http:statuscode:`400 Bad request`:
     31     The request is malformed. The bank replies with an `ErrorDetail` object.
     32   :http:statuscode:`401 Unauthorized`:
     33     Authentication failed, likely the credentials are wrong.
     34   :http:statuscode:`404 Not found`:
     35     The endpoint is wrong or the user name is unknown. The bank replies with an `ErrorDetail` object.