Skip to main content

request_customer_info_update

SEP - 6SEP - 31

Additional customer information is required

Params

(4)

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 ID of the transaction

string

2. message

Human readable explanation of transaction status

string

3. required_customer_info_message

Human readable explanation indicating why the SEP-12 information provided by the user is not sufficient to complete the transaction. This field is only relevant for SEP-6 transactions and must be set.

string

4. required_customer_info_updates

A list of SEP-9 fields that require updates from the user via SEP-12. This field is only relevant for SEP-6 transactions and must be set.

array

Result

(Response)
id
string

The ID of the transaction

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
object

The amount expected in the payment

asset
string
amount
string
amount_in
object

Amount expected/received by anchor

asset
string
amount
string
amount_out
object

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

asset
string
amount
string
amount_fee
object

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

asset
string
amount
string
fee_details
object

Description of fee charged by the anchor.

total
number
asset
string
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
object

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

Request

[
  {
    "id": 1,
    "jsonrpc": "2.0",
    "method": "request_customer_info_update",
    "params": {
      "transaction_id": "1c186184-09ee-486c-82a7-aa7a0ab1119d",
      "message": "Customer info requested"
    }
  }
]

Response

[
  {
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
      "id": "1c186184-09ee-486c-82a7-aa7a0ab1119d",
      "sep": "24 / 31",
      "kind": "deposit/withdrawal/receive",
      "status": "...",
      "amount_expected": {
        "amount": "1",
        "asset": "stellar:USDC:G...5"
      },
      "amount_in": {
        "amount": "1",
        "asset": "stellar:USDC:G...5"
      },
      "amount_out": {
        "amount": "0.9",
        "asset": "iso4217:USD"
      },
      "amount_fee": {
        "amount": "0.1",
        "asset": "stellar:USDC:G...5"
      },
      "started_at": "2023-08-04T10:04:06.280923Z",
      "updated_at": "2023-08-04T10:04:15.716233Z",
      "message": "Transaction status message",
      "source_account": "G...W",
      "destination_account": "G...S"
    }
  }
]