The TRANSFER() function, get the status of a transfer + MORE

Terminal · **Posted:** Wed Jan 09, 2008 1:17 pm

A good one...

This will work in update 0.73 and onwards.

You can use the TRANSFER() function, and the TRANSFERSTATUS() function.

This allows people to pay you, and for you to verify whether their payment was successful or not. (useful if you are selling something).

Example:

Code:

SAY testing transfer function

$m = transfer(test,5,test transfer)
WAITFOR $m

SAY the Keycode is $m
SAY getting status of transfer...

$s = transferstatus($m)
$s2 = transferdate($m)
$s3 = transfertime($m)
$s4 = transferdescription($m)
$s5 = transferamount($m)
$s6 = transfertousername($m)
$s7 = transferfromusername($m)

waitfor $s,$s2,$s3,$s4,$s5,$s6,$s7

SAY Status: $s
SAY Date: $s2
SAY Time: $s3
SAY Description: $s4
SAY Amount: $$s5
SAY To: $s6
SAY From: $s7

IF $s = COMPLETE then
   say Thank you for your purchase!{green}
ELSE
   say Your transfer failed! Come back when you have more money...{orange}
ENDif

The TRANSFER(username,amount,description) function returns a key code, which is just like a transfer ID. This transfer ID can then be used in the following functions, to download other information about the transfer!

$v = TRANSFERSTATUS(transferid)
Get the status of a transfer. This will return one of the following: COMPLETE, NOT-FOUND, INVALID-USER, FAILED-SET, INSUFFICIENT, BAD-TO-USERNAME, or BAD-FROM-USERNAME.

$v = TRANSFERAMOUNT(transferid)
This will return the amount of the transfer.

$v = TRANSFERDESCRIPTION(transferid)
This will return the description of the transfer.

$v = TRANSFERTOUSERNAME(transferid)
This will return the username of who received the money in the transfer.

$v = TRANSFERFROMUSERNAME(transferid)
This will return the username of who sent the money in the transfer.

$v = TRANSFERDATE(transferid)
This will return the date of the transfer.

$v = TRANSFERTIME(transferid)
This will return the time of the transfer.

(these are all remote functions and require WAITFOR)

Again, the transfer ID is obtained in the example, by using the transfer() function. It may be a good idea to log transfer ID's to your server so you can keep track of orders.

If you are going to log something, log the transfer ID, as you can use it later to get information on the transfer, far into the future.

BigBob85 · **Posted:** Wed Jan 09, 2008 10:40 pm

Is there a keycode unique?

Terminal · **Posted:** Wed Jan 09, 2008 10:50 pm

BigBob85 wrote:

Is there a keycode unique?

All keycodes are unique.

Nabster · **Joined:** Tue Jan 22, 2008 6:46 pm **Posts:** 13

Will this work if the user the money is being transferred to is offline?

Dodomaster · **Joined:** Thu Dec 27, 2007 1:50 pm **Posts:** 140

Nabster wrote:

Will this work if the user the money is being transferred to is offline?

Yes. At least I think so.

BigBob85 · **Posted:** Thu Jan 31, 2008 12:15 am

I dont see any reason why it shouldnt.

The TRANSFER() function, get the status of a transfer + MORE

Who is online