From PhpCOIN Documentation
A Purchase Order is basically an invoice with no payment ~ you have not received any money yet. You could set up an Invoice paylink and ask the client to provide their PO# as per the example below. Or you could create a fully automated Purchase Order paylink ~ albeit with some code writing and database manipulation.
Creating a Purchase Order paylink requires capturing the PO#. You need to know the PO# so it can be reconciled against an order within phpCOIN, and an invoice sent with the Purchase Order Number (PO#) on it.
Also it should be noted that most companies that use Purchase Orders generally will not send out a payment without first receiving an invoice with their PO# on it. Currently to capture the PO# you would have to edit the database to add a field to the invoice, and also edit code to work with the new field.
If you do not want to write custom code for your version of phpCOIN, the following paylink example will most likely do for now.
- Log into phpCOIN on your website as an admin
- Add the vendor
- Add paylinks
Admin -> Vendors
If Purchase Order exists in the list of available vendors, you can simply edit the existing record. If it does not exist, then click [Add New] to add Purchase Order as a payment method that you will accept. The info should look like the following:
Vendor ID: (will be auto-completed by phpCOIN) Status: On (Off if you wish to stop accepting this payment method) Vendor Name: Invoice/Purchase Order (for the drop-down lists) Buy Return Param Name: po Buy Return Param Value: 1 URL / Website: http://my.phpcoin.com/mod.php?mod=orders&mode=return Use IPN: YES (We do NOT want phpCOIN to mark the invoice as paid if the user clicks the confirm button) Notes:
Admin -> PayLinks
Select the PayLink you want to edit, or click [Create New] to create a new one. Paste the following code into the order link, changing the parameters shown in bold:
Vendor Product Id: (Auto-created by phpCOIN) Vendor ID: (From the drop-down, choose "Purchase Order") Product ID: (From the drop-down, choose the product that this paylink applies to) Description: Purchase Order Product x (for listing) Order Link: Insert your instructions or form link, similar to the following: code of a FORM with a text box for the PO# and a submit button that e-mails your billing department and/or updates the database.
In the above link, the <> tells phpCOIN that it should replace the tag name with the actual value at run-time. For example, leaving <return_link_buy> means that phpCOIN will enter the actual return URL when it displays an order paylink. It also means that you could move your site to another URL entirely but would not need to adjust your paylinks.
Lather, Rinse, Repeat
Repeat the above steps as many times as necessary, so that you end up with one PayLink for each product or service that will allow Purchase Order as a payment method.