Version: 2.11

notify_interactive_flow_completed

SEP-24

Platform has collected the transaction amounts and fees from the business

Params

(7)

Please note that parameter structure within the request must contain named parameters as a by-name object, and not as positional arguments in a by-position array

1. transaction_id (required)

The unique identifier of this transaction.

string

A unique transaction identifier.

2. message

Human readable explanation of transaction status.

string

A human readable message.

3. amount_in (required)

The amount expected in the payment

amount

string

required

A numerical representation of an amount of some asset.

asset

string

required

The asset to be received by the Anchor

4. amount_out (required)

Amount sent by anchor to user

amount

string

required

A numerical representation of an amount of some asset.

asset

string

required

The asset to be sent by anchor to user at end of transaction

5. amount_fee

DEPRECATED in favor of fee_details. Amount of fee charged by anchor

amount

string

required

A numerical representation of an amount of some asset.

6. fee_details (required)

Description of fees charged by the anchor

Description of fee charged by the anchor.

total

number

required

asset

string

required

details

array[object]

Details about fee charged.

name

string

description

string

amount

number

7. amount_expected

The amount expected in the payment

amount

string

required

A numerical representation of an amount of some asset.

Result

(notify_interactive_flow_completedResponse)

string

A unique transaction identifier.

sep

integer

Protocol of the transaction.

Allowed values:

62431

kind

string

The kind of transaction that is desired.

Allowed values:

undefinedreceivedepositdeposit-exchangewithdrawalwithdrawal-exchange

status

string

Processing status of the transaction.

Allowed values:

pending_anchorpending_trustpending_userpending_user_transfer_startpending_user_transfer_completeincompleteno_markettoo_smalltoo_largepending_senderpending_receiverpending_transaction_info_updatepending_customer_info_updatecompletedrefundedexpirederrorpending_externalpending_stellar

amount_expected

The amount expected in the payment.

amount

string

A stringified amount of an asset.

asset

string

An asset.

amount_in

Amount expected/received by anchor.

amount

string

A stringified amount of an asset.

asset

string

An asset.

amount_out

The amount expected to be sent by anchor to user at end of transaction.

amount

string

A stringified amount of an asset.

asset

string

An asset.

amount_fee

deprecated

DEPRECATED in favour of fee_details. The total amount charged in fees for processing all refund payments, in units of amount_in_asset.

amount

string

A stringified amount of an asset.

asset

string

An asset.

fee_details

Description of fee charged by the anchor.

total

number

required

asset

string

required

details

array[object]

Details about fee charged.

quote_id

string

The id returned from a SEP-38 POST /quote response

started_at

string

Start date and time of transaction.

updated_at

string

The date and time of transaction reaching the current status.

completed_at

string

The date and time of transaction reaching completed or refunded status.

transfer_received_at

string

The date and time of receiving transfer.

message

string

Human readable explanation of transaction status

refunds

An object describing any on or offchain refund associated with this transaction.

amount_refunded

object

The total amount refunded in units of amount_in_asset.

amount_fee

object

The total amount charged in fees for processing all refund payments, in units of amount_in_asset.

payments

array[object]

A list of objects containing information on the individual payments made back as refunds.

Example

Example request to the notify_interactive_flow_completed method.

Request

cURL
JavaScript
Python
JSON

curl -X POST \
-H 'Content-Type: application/json' \
-d '{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "notify_interactive_flow_completed",
  "params": {
    "transaction_id": "1c186184-09ee-486c-82a7-aa7a0ab1119d",
    "message": "Interactive flow completed successfully.",
    "amount_in": {
      "amount": 1,
      "asset": "iso4217:USD"
    },
    "amount_out": {
      "amount": 0.9,
      "asset": "stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
    },
    "amount_fee": {
      "amount": 0.1,
      "asset": "iso4217:USD"
    },
    "amount_expected": {
      "amount": 1
    }
  }
}' \
https://platform-server.exampleanchor.com | jq

let requestBody = {
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "notify_interactive_flow_completed",
  "params": {
    "transaction_id": "1c186184-09ee-486c-82a7-aa7a0ab1119d",
    "message": "Interactive flow completed successfully.",
    "amount_in": {
      "amount": 1,
      "asset": "iso4217:USD"
    },
    "amount_out": {
      "amount": 0.9,
      "asset": "stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
    },
    "amount_fee": {
      "amount": 0.1,
      "asset": "iso4217:USD"
    },
    "amount_expected": {
      "amount": 1
    }
  }
}
let res = await fetch('https://platform-server.exampleanchor.com', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(requestBody),
})
let json = await res.json()
console.log(json)

import json, requests
res = requests.post('https://platform-server.exampleanchor.com', json={
    "jsonrpc": "2.0",
    "id": 8675309,
    "method": "notify_interactive_flow_completed",
    "params": {
        "transaction_id": "1c186184-09ee-486c-82a7-aa7a0ab1119d",
        "message": "Interactive flow completed successfully.",
        "amount_in": {
            "amount": 1,
            "asset": "iso4217:USD"
        },
        "amount_out": {
            "amount": 0.9,
            "asset": "stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
        },
        "amount_fee": {
            "amount": 0.1,
            "asset": "iso4217:USD"
        },
        "amount_expected": {
            "amount": 1
        }
    }
})
print(json.dumps(res.json(), indent=4))

{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "notify_interactive_flow_completed",
  "params": {
    "transaction_id": "1c186184-09ee-486c-82a7-aa7a0ab1119d",
    "message": "Interactive flow completed successfully.",
    "amount_in": {
      "amount": 1,
      "asset": "iso4217:USD"
    },
    "amount_out": {
      "amount": 0.9,
      "asset": "stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
    },
    "amount_fee": {
      "amount": 0.1,
      "asset": "iso4217:USD"
    },
    "amount_expected": {
      "amount": 1
    }
  }
}

Result

{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "id": "1c186184-09ee-486c-82a7-aa7a0ab1119d",
    "sep": "24",
    "kind": "deposit",
    "status": "completed",
    "amount_expected": {
      "amount": "1",
      "asset": "stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
    },
    "amount_in": {
      "amount": "1",
      "asset": "stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
    },
    "amount_out": {
      "amount": "0.9",
      "asset": "iso4217:USD"
    },
    "amount_fee": {
      "amount": "0.1",
      "asset": "stellar:USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
    },
    "started_at": "2023-08-04T10:04:06.280923Z",
    "updated_at": "2023-08-04T10:04:15.716233Z",
    "message": "Transaction complete",
    "source_account": "GB4GJAV4Q7DPGU7WI3H5TMVKEYZJ4JFLFEF3O3TRJKDPXK7NAMRBXWFL",
    "destination_account": "GDIN5ZULIOT5YPBIXJXFGNH4TCNTDKIA4ZF6QQE3S2P5P44BHCQQJNDC"
  }
}