order.payment.pending

Last modified January 29, 2019

This article applies to Contextual Commerce. (Looking for Classic Commerce documentation?)

The order.payment.pending server webhook event is fired when an order has been processed but payment from the buyer has not yet been completed (for example, when a buyer selects wire transfer as their payment method or buys using a purchase order).

About Webhook Expansion

When webhook expansion is enabled, order.payment.pending will include the entire customer account object, rather than just the account ID.

Contents of Event Payload

NameTypeDescription
orderstringinternal order ID
idstringinternal order ID
referencestringcustomer-facing order reference
buyerReferencestringfor purchase order transactions, the optional purchase order number entered by the buyer
completedBoolean"true" for a completed order; always false for order.payment.pending
changedIntegerdate of the most recent update to the order record, in milliseconds
changedValueIntegerdate of the most recent update to the order record, in milliseconds (backward compatibility)
changedInSeconds integerdate of the most recent update to the order record, in seconds
changedDisplaystringdate of the most recent update to the order record, formatted for display based on the language in which the order was processed
languagestringtwo-character ISO code for the order language
liveBoolean"false" for a test order
currencystringthree-character ISO code for the order currency
payoutCurrencystringthree-character ISO code for the currency in which your disbursement will be made
invoiceUrlstringURL of the customer-facing invoice for this order
accountstring (expansion disabled)
object (expansion enabled)
FastSpring-generated customer account ID (expansion disabled)
details of the customer account (expansion enabled)
account.idstringFastSpring-generated customer account ID
account.accountstringFastSpring-generated customer account ID
account.contactobjectcustomer's contact details
account.contact.firststringcustomer's first name
account.contact.laststringcustomer's last name
account.contact.emailstringcustomer's email address
account.contact.companystringcustomer's company name
account.contact.phonestringcustomer's telephone number
account.languagestringtwo-character ISO code for the language associated with the customer's account
account.countrystringtwo-character ISO code for the country associated with the customer's account
account.lookupobjectmultiple-field object containing lookup IDs for the customer account (e.g. for use with the /accounts endpoint of the FastSpring API)
account.lookup.globalstringexternal customer account ID, generated by FastSpring
account.lookup.customstringoptional custom account ID specified via the /accounts endpoint of the FastSpring API (not shown in examples below)
account.urlstringurl for the Store's default account management page
totalnumberorder total in the transaction's currency
totalDisplaystringorder total, formatted for display in the transaction's currency
totalInPayoutCurrencynumberorder total in the currency of your FastSpring disbursements
totalInPayoutCurrencyDisplaystringorder total, formatted for display in the currency of your FastSpring disbursements
taxnumberamount of tax
taxDisplaystringamount of tax, formatted for display in the transaction's currency
taxInPayoutCurrencynumberamount of tax in the currency of your FastSpring disbursements
taxInPayoutCurrencyDisplaystringamount of tax, formatted for display in the currency of your FastSpring disbursements
subtotalnumberorder subtotal in the transaction's currency
subtotalDisplaystringorder subtotal, formatted for display in the transaction's currency
subtotalInPayoutCurrencynumberorder subtotal in the currency of your FastSpring disbursements
subtotalInPayoutCurrencyDisplaystringorder subtotal, formatted for display in the currency of your FastSpring disbursements
discountnumbertotal discount applied to the order in the transaction's currency
discountDisplaystringtotal discount applied to the order, formatted for display in the transaction's currency
discountInPayoutCurrencynumbertotal discount applied to the order, in the currency of your FastSpring disbursements
discountInPayoutCurrencyDisplaystringtotal discount applied to the order, formatted for display in the currency of your FastSpring disbursements
discountWithTaxnumberdiscount amount including tax
discountWithTaxDisplaystringdiscount amount including tax, formatted for display in the transaction's currency
discountWithTaxInPayoutCurrencynumberdiscount amount including tax, in the currency of your FastSpring disbursements
discountWithTaxInPayoutCurrencyDisplaystringdiscount amount including tax, formatted for display in the currency of your FastSpring disbursements
billDescriptorstringthe description information sent to the payment account for display on the customer's statement (always "N/A" for this event)
paymentobjectdetails about the transaction's payment method used for the purchase; blank for order.payment.pending since payment has not yet been made
reasonstringreason why the payment is pending (e.g. "wireTransfer", "purchaseOrder")
customerobjectdetails about the customer
customer.firststringcustomer's first name
customer.laststringcustomer's last name
customer.emailstringcustomer's email address
customer.companystringcustomer's company name
customer.phonestringcustomer's telephone number
addressobjectdetails about the customer address associated with this order
address.citystringname of the city in the address
address.addressLine1stringfirst address line (for physical shipments or when Force physical address collection for all orders is enabled for the Storefront)
address.addressLine2stringsecond, optional address line (for physical shipments or when Force physical address collection for all orders is enabled for the Storefront)
address.regionCodestringtwo-character ISO code for the state of the address (present for U.S. addresses only)
address.regionDisplaystringstate or region of the address, formatted for display
address.regionstringstate or region of the address (backward compatibility)
address.postalCodestringpostal code of the address
address.countrystringcountry of the address
address.displaystringconcatenated string of address information, formatted for display
recipientsarraydetails on the customer and / or the recipient of gift purchases; for non-gift purchases, info will be the same as customer and address info
recipients.recipientobjectobject containing all details of the current recipient in the array
recipients.recipient.firststringrecipient's first name
recipients.recipient.laststringrecipient's last name
recipients.recipient.emailstringrecipient's email address
recipients.recipient.companystringrecipient's company (optional)
recipients.recipient.phonestringrecipient's phone number
recipients.recipient.accountstring (expansion disabled)
object (expansion enabled)
recipient's FastSpring-generated customer account ID (expansion disabled)
details of the recipient's customer account (expansion enabled)
recipients.recipient.account.idstringrecipient's FastSpring-generated customer account ID
recipients.recipient.account.accountstringrecipient's FastSpring-generated customer account ID (backward compatibility)
recipients.recipient.account.contactobjectrecipient's contact details
recipients.recipient.account.contact.firststringrecipient's first name
recipients.recipient.account.contact.laststringrecipient's last name
recipients.recipient.account.contact.emailstringrecipient's email address
recipients.recipient.account.contact.companystringrecipient's company name
recipients.recipient.account.contact.phonestringrecipient's telephone number
recipients.recipient.account.languagestringtwo-character ISO code for the language associated with the recipient'account
recipients.recipient.account.countrystringtwo-character ISO code for the country associated with the recipient'account
recipients.recipient.account.lookupobjectmultiple-field object containing lookup IDs for the recipient'customer account (e.g. for use with the /accounts endpoint of the FastSpring API)
recipients.recipient.account.lookup.globalstringrecipient'external customer account ID, generated by FastSpring
recipients.recipient.account.lookup.customstringoptional custom account ID specified via the /accounts endpoint of the FastSpring API (not shown in examples below)
recipients.recipient.account.urlstringurl for the Store's default account management page
recipients.recipient.addressobjectmutli-line object containing recipient address information
recipients.recipient.address.addressLine1stringrecipient's street address (when a physical product was in the order or "Force physical address collection" was enabled)
recipients.recipient.address.citystringrecipient's city
recipients.recipient.address.regionCodestringtwo-character ISO code for the state of the address (present for U.S. addresses only)
recipients.recipient.address.regionDisplaystringstate or region of the address, formatted for display
recipients.recipient.address.regionstringstate or region of the address
recipients.recipient.address.postalCodestringpostal code of the address
recipients.recipient.address.countrystringcountry of the address
recipients.recipient.address.displaystringconcatenated string of address information, formatted for display
notesarrayoptional internal order notes entered via Dashboard
itemsarrayproducts included in the order, one object per product
items.productstringproduct path / product ID
items.quantityintegerquantity of the current product in this transaction
items.displaystringcustomer-facing Display name of the product
items.skustringoptional internal SKU ID (e.g. your part number) for the current product
items.subtotalnumbersubtotal for the current product, in the transaction's currency
items.subtotalDisplaystringsubtotal for the current product, formatted for display in the transaction's currency
items.subtotalInPayoutCurrencynumbersubtotal for the current product, in the currency of your FastSpring disbursements
items.subtotalInPayoutCurrencyDisplaystringsubtotal for the current product, formatted for display in the currency of your FastSpring disbursements
items.attributesobjectmultiple-field object containing optional product-level attributes for the current product
items.discountnumberamount of any discount applied to the current product
items.discountDisplaystringamount of any discount applied to the current product, formatted for display in the transaction's currency
items.discountInPayoutCurrencynumberamount of any discount applied to the current product, in the currency of your FastSpring disbursements
items.discountInPayoutCurrencyDisplaystringamount of any discount applied to the current product, formatted for display in the currency of your FastSpring disbursements
items.subscriptionstringID of the subscription associated with the current product; blank for order.payment.pending because the subscription has not yet been created
items.fulfillmentsobjectmultiple-field object containing details of fulfillment actions associated with the current product (filelicense, or instructions)
items.fulfillments.<fulfillment ID>arrayidentifier for the current fulfillment action (other than instructions); array consists of fulfillment attributes
items.fulfillments.<fulfillment ID>.licensestring(when "type" = "license") license key associated with the current fulfillment action
items.fulfillments.<fulfillment ID>.displaystring

name of the current fulfillment action:

when "type" = "license", "License Key"
when "type" = "file", <download file name>

items.fulfillments.<fulfillment ID>.sizeinteger(when "type" = "file") size of the download file, in bytes
items.fulfillments.<fulfillment ID>.filestring(when "type" = "file") order-specific URL for the product download associated with this fulfillment action
items.fulfillments.<fulfillment ID>.typestring"license" or "file"
items.fulfillments.instructionsstringcontents of the Post Order Instructions field for the current product
items.driverobjectwhen the current item was sold as a cross-sell or an upsell, or when the current item is a bundle child, indicates relationship to driving product
items.driver.typestringrelationship to parent / triggering item (e.g. "cross-sell", "bundle", "configuration")
items.driver.pathstringproduct path / ID of parent / triggering item;
when type = "cross-sell" this indicates the triggering item;
when type = "bundle" this indicates in the bundle parent, meaning that the current item is a child of the specified bundle product
when type = "configuration" this indicates the triggering item (as with a cross-sell)
couponsarraylist of coupon IDs applied to the order (currently, only one coupon can be applied to an order)


Examples

Example 1 - Webhook Expansion Disabled

order.payment.pending webhook example (webhook expansion disabled)
{  
   "order":"zTF3fNyVQ8e2PqZlnrocpg",
   "id":"zTF3fNyVQ8e2PqZlnrocpg",
   "reference":"FUR190121-3304-90135",
   "buyerReference":null,
   "completed":false,
   "changed":1548104392474,
   "changedValue":1548104392474,
   "changedInSeconds":1548104392,
   "changedDisplay":"1/21/19",
   "language":"en",
   "live":true,
   "currency":"USD",
   "payoutCurrency":"USD",
   "invoiceUrl":"https://furiousfalcon.onfastspring.com/account/order/FUR190121-3304-90135/invoice",
   "account":"N8FjcSWcQNeYCc-suM1O8g",
   "total":17.95,
   "totalDisplay":"$17.95",
   "totalInPayoutCurrency":17.95,
   "totalInPayoutCurrencyDisplay":"$17.95",
   "tax":0.0,
   "taxDisplay":"$0.00",
   "taxInPayoutCurrency":0.0,
   "taxInPayoutCurrencyDisplay":"$0.00",
   "subtotal":17.95,
   "subtotalDisplay":"$17.95",
   "subtotalInPayoutCurrency":17.95,
   "subtotalInPayoutCurrencyDisplay":"$17.95",
   "discount":2.0,
   "discountDisplay":"$2.00",
   "discountInPayoutCurrency":2.0,
   "discountInPayoutCurrencyDisplay":"$2.00",
   "discountWithTax":2.0,
   "discountWithTaxDisplay":"$2.00",
   "discountWithTaxInPayoutCurrency":2.0,
   "discountWithTaxInPayoutCurrencyDisplay":"$2.00",
   "billDescriptor":"N/A",
   "payment":{  

   },
   "reason":"wireTransfer",
   "customer":{  
      "first":"Leeroy",
      "last":"Jenkins",
      "email":"ne1@all.com",
      "company":"Chicken Danger, Inc.",
      "phone":"8054099008"
   },
   "address":{  
      "addressLine1":"801 Garden Street",
      "city":"Santa Barbara",
      "regionCode":"CA",
      "regionDisplay":"California",
      "region":"California",
      "postalCode":"93101",
      "country":"US",
      "display":"801 Garden Street, Santa Barbara, California, 93101, US"
   },
   "recipients":[  
      {  
         "recipient":{  
            "first":"Leeroy",
            "last":"Jenkins",
            "email":"ne1@all.com",
            "company":"Chicken Danger, Inc.",
            "phone":"8054099008",
            "account":"N8FjcSWcQNeYCc-suM1O8g",
            "address":{  
               "addressLine1":"801 Garden Street",
               "city":"Santa Barbara",
               "regionCode":"CA",
               "regionDisplay":"California",
               "region":"California",
               "postalCode":"93101",
               "country":"US",
               "display":"801 Garden Street, Santa Barbara, California, 93101, US"
            }
         }
      }
   ],
   "notes":[  

   ],
   "items":[  
      {  
         "product":"glide",
         "quantity":1,
         "display":"Glide",
         "sku":null,
         "subtotal":17.95,
         "subtotalDisplay":"$17.95",
         "subtotalInPayoutCurrency":17.95,
         "subtotalInPayoutCurrencyDisplay":"$17.95",
         "discount":2.0,
         "discountDisplay":"$2.00",
         "discountInPayoutCurrency":2.0,
         "discountInPayoutCurrencyDisplay":"$2.00",
         "fulfillments":{  
            "instructions":"<p><strong>Your Glide license key</strong><br/></p><p><strong>Downloading Glide</strong></p><p>You can download the installer from .</p>"
         }
      }
   ]
}


Example 2 - Webhook Expansion Enabled

order.payment.pending webhook example (webhook expansion enabled)
{  
   "order":"pYRyEyHlRXSfu3IciIWORA",
   "id":"pYRyEyHlRXSfu3IciIWORA",
   "reference":"FUR190121-3304-56160",
   "buyerReference":null,
   "completed":false,
   "changed":1548105407015,
   "changedValue":1548105407015,
   "changedInSeconds":1548105407,
   "changedDisplay":"1/21/19",
   "language":"en",
   "live":true,
   "currency":"USD",
   "payoutCurrency":"USD",
   "invoiceUrl":"https://furiousfalcon.onfastspring.com/account/order/FUR190121-3304-56160/invoice",
   "account":{  
      "id":"N8FjcSWcQNeYCc-suM1O8g",
      "account":"N8FjcSWcQNeYCc-suM1O8g",
      "contact":{  
         "first":"Richard B.",
         "last":"Riddack",
         "email":"ne1@all.com",
         "company":"Furia Exports, Ltd.",
         "phone":"8054099008"
      },
      "language":"en",
      "country":"US",
      "lookup":{  
         "global":"TVWhu0iwQhKJyuhpT_2yMw"
      },
      "url":"https://furiousfalcon.onfastspring.com/account"
   },
   "total":17.95,
   "totalDisplay":"$17.95",
   "totalInPayoutCurrency":17.95,
   "totalInPayoutCurrencyDisplay":"$17.95",
   "tax":0.0,
   "taxDisplay":"$0.00",
   "taxInPayoutCurrency":0.0,
   "taxInPayoutCurrencyDisplay":"$0.00",
   "subtotal":17.95,
   "subtotalDisplay":"$17.95",
   "subtotalInPayoutCurrency":17.95,
   "subtotalInPayoutCurrencyDisplay":"$17.95",
   "discount":2.0,
   "discountDisplay":"$2.00",
   "discountInPayoutCurrency":2.0,
   "discountInPayoutCurrencyDisplay":"$2.00",
   "discountWithTax":2.0,
   "discountWithTaxDisplay":"$2.00",
   "discountWithTaxInPayoutCurrency":2.0,
   "discountWithTaxInPayoutCurrencyDisplay":"$2.00",
   "billDescriptor":"N/A",
   "payment":{  

   },
   "reason":"wireTransfer",
   "customer":{  
      "first":"Richard B.",
      "last":"Riddack",
      "email":"ne1@all.com",
      "company":"Furia Exports, Ltd.",
      "phone":"8054099008"
   },
   "address":{  
      "addressLine1":"801 Garden Street",
      "city":"Santa Barbara",
      "regionCode":"CA",
      "regionDisplay":"California",
      "region":"California",
      "postalCode":"93101",
      "country":"US",
      "display":"801 Garden Street, Santa Barbara, California, 93101, US"
   },
   "recipients":[  
      {  
         "recipient":{  
            "first":"Richard B.",
            "last":"Riddack",
            "email":"ne1@all.com",
            "company":"Furia Exports, Ltd.",
            "phone":"8054099008",
            "account":{  
               "id":"N8FjcSWcQNeYCc-suM1O8g",
               "account":"N8FjcSWcQNeYCc-suM1O8g",
               "contact":{  
                  "first":"Richard B.",
                  "last":"Riddack",
                  "email":"ne1@all.com",
                  "company":"Furia Exports, Ltd.",
                  "phone":"8054099008"
               },
               "language":"en",
               "country":"US",
               "lookup":{  
                  "global":"TVWhu0iwQhKJyuhpT_2yMw"
               },
               "url":"https://furiousfalcon.onfastspring.com/account"
            },
            "address":{  
               "addressLine1":"801 Garden Street",
               "city":"Santa Barbara",
               "regionCode":"CA",
               "regionDisplay":"California",
               "region":"California",
               "postalCode":"93101",
               "country":"US",
               "display":"801 Garden Street, Santa Barbara, California, 93101, US"
            }
         }
      }
   ],
   "notes":[  

   ],
   "items":[  
      {  
         "product":"glide",
         "quantity":1,
         "display":"Glide",
         "sku":null,
         "subtotal":17.95,
         "subtotalDisplay":"$17.95",
         "subtotalInPayoutCurrency":17.95,
         "subtotalInPayoutCurrencyDisplay":"$17.95",
         "discount":2.0,
         "discountDisplay":"$2.00",
         "discountInPayoutCurrency":2.0,
         "discountInPayoutCurrencyDisplay":"$2.00",
         "fulfillments":{  
            "instructions":"<p><strong>Your Glide license key</strong><br/></p><p><strong>Downloading Glide</strong></p><p>You can download the installer from .</p>"
         }
      }
   ]
}