Difference between revisions of "Transaction result"

From Second Life Wiki
Jump to navigation Jump to search
m
m
Line 12: Line 12:
{{{!}} {{Prettytable|style=margin-top:0;}}
{{{!}} {{Prettytable|style=margin-top:0;}}
{{!}}- {{Hl2}}
{{!}}- {{Hl2}}
! Function
! {{LSLGC|Transfer|llTransfer*}} Function
----
----
''{{LSL Param|data}}'' CSV Contents
''{{LSL Param|data}}'' CSV Contents

Revision as of 15:19, 14 December 2011

Emblem-important-red.png Pre-release Documentation Warning!

This event is not available yet. This documentation was written prior to its final release so it may not match the final implementation.

Description

Event: transaction_result( key id, integer success, string data ){ ; }

Triggered when task receives asynchronous data

• key id matches the return of the llTransfer* function
• integer success TRUE if the transfer succeeded otherwise FALSE.
• string data On successful transactions this will contain a CSV of information pertaining to the transaction. In failure, it will contain an error tag.
llTransfer* Function

data CSV Contents

Error Tag Error Tag Description
key llTransferLindenDollarskey destination, integer amount )

key destination, integer amount ]

LINDENDOLLAR_ENTITYDOESNOTEXIST The destination UUID is not a valid agent.
LINDENDOLLAR_INSUFFICIENTFUNDS The source agent does not have enough L$ for the transfer
INVALID_AGENT Destination agent is not a valid UUID
INVALID_AMOUNT Amount is <= 0
THROTTLED The scripted L$ throttle was hit for this object owner.
MISSING_PERMISSION_DEBIT The script does not have debit permission
GROUP_OWNED The object is group owned and thus can't give money
TRANSFERS_DISABLED L$ transfers are disabled in the region
EXPIRED The simulator timed out waiting for a response from the back-end service.
SERVICE_ERROR There was an error connecting to the back-end service

Examples

Deep Notes

Release Notes

  • New LSL event: transaction_result(key id, integer success, string data)
    This event is triggered from an llTransfer* call (currently only llTransferLindenDollars).
    • id: matches the return value of the llTransfer* call and if the transaction was a success will match the 'transaction id' shown in transaction history on secondlife.com
    • success: TRUE if the transfer succeeded otherwise FALSE.
    • data: On successful transactions will contain a CSV of destination ID and amount transferred. In failure cases it will contain an error tag on failure.
  • Error Tags for llTransferLindenDollars:
    • LINDENDOLLAR_ENTITYDOESNOTEXIST - The destination UUID is not a valid agent.
    • LINDENDOLLAR_INSUFFICIENTFUNDS - The source agent does not have enough L$ for the transfer
    • INVALID_AGENT - Destination agent is not a valid UUID
    • INVALID_AMOUNT - Amount is <= 0
    • THROTTLED - The scripted L$ throttle was hit for this object owner.
    • MISSING_PERMISSION_DEBIT - The script does not have debit permission
    • GROUP_OWNED - The object is group owned and thus can't give money
    • TRANSFERS_DISABLED - L$ transfers are disabled in the region
    • EXPIRED - The simulator timed out waiting for a response from the back-end service.
    • SERVICE_ERROR - There was an error connecting to the back-end service

Signature

event void transaction_result( key id, integer success, string data );