Sep31PostTransactionsResponse

Response payload returned by SEP-31 POST /transactions.

Carries the persistent transaction id and — when the anchor has already determined the on-chain payment instructions — the Stellar account and memo the Sending Anchor must use. The Stellar fields are optional: per spec "Success (201 Created)", absent values indicate the anchor is still processing the request. The transaction is in pending_receiver status; the anchor will advance it to pending_sender once payment fields are populated, or to error if the transaction cannot proceed. The Sending Anchor should poll or register a callback until one of those two transitions occurs.

Both HTTP 200 and HTTP 201 responses are accepted as success by the SDK.

Usage

val response = sep31Service.postTransactions(request, jwt)
if (response.stellarAccountId != null) {
    println("Send payment to ${response.stellarAccountId} with memo ${response.stellarMemo}")
} else {
    println("Anchor is still processing; poll GET /transactions/${response.id}")
}

Example JSON

{
  "id": "11111111-1111-1111-1111-111111111111",
  "stellar_account_id": "GBRPYHIL2CI3FNQ4BXLFMNDLFJUNPU2HY3ZMFSHONUCEOASW7QC7OX2H",
  "stellar_memo_type": "hash",
  "stellar_memo": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA="
}

See also