Doba

How to fix API CVV2 error

 
Here are the instructions for using the fundOrder API method:
 
http://www.doba.com/developer/20110301/method_reference_retailer_order.php#fundOrder
 

fundOrder

Funds a previously created order currently in the "Awaiting Payment" state.

fundOrder Request Parameters

  • Required
    • authentication
      • password
      • username
    • cvv2 - The CVV2 Code found on the back of the Credit Card. See Wikipedia for more information.
    • fund_method - Can be one of 'default_payment_account', 'payment_account_id', 'new_payment_info'. Depending on the method different parameters are required.
    • retailer_id - The merchants retailer_id.
  • Optional
    • billing_city - The city on the Credit Card account. - This is required when the new_payment_info fund_method is specified.
    • billing_country - US = United States, CA = Canada, AU = Australia, BB = Barbados, IE = Ireland, MY = Malaysia, SG = Singapore, GB = United Kingdom, DE = Germany, PR = Puerto Rico, NZ = New Zealand - No other options are currently allowed. - This is required when the new_payment_info fund_method is specified.
    • billing_firstname - The first name on the Credit Card account. - This is required when the new_payment_info fund_method is specified.
    • billing_lastname - The last name on the Credit Card account. - This is required when the new_payment_info fund_method is specified.
    • billing_phone - The phone number for the owner of the Credit Card. - This is required when the new_payment_info fund_method is specified.
    • billing_postal - The postal/zip code on the Credit Card account. - This is required when the new_payment_info fund_method is specified.
    • billing_state - Two character abbreviation of the state on the Credit Card account. - This is required when the new_payment_info fund_method is specified.
    • billing_street - The billing street address on the Credit Card account. - This is required when the new_payment_info fund_method is specified.
    • credit_card_exp_month - 2 Digits - The month the Credit Card expires. Found on the front of the card. - This is required when the new_payment_info fund_method is specified.
    • credit_card_exp_year - 4 Digits - The year the Credit Card expires. Found on the front of the card. - This is required when the new_payment_info fund_method is specified.
    • credit_card_number - The 15 or 16 digit Credit Card number on the face of the card. - This is required when the new_payment_info fund_method is specified.
    • order_group_id - The order group_id to fund. - Either this or an order_id is required.
    • order_ids
      • int
    • payment_account_id - The payment_account_id assigned to the payment profile within the Doba account. - This is required when the payment_account_id fund_method is specified.

fundOrder Response Parameters

  • payment_account_id - integer(11) - The ID assigned to the Doba payment account. This ID can be used to fund future orders. Only returned when creating a new payment account using the "new_payment_info" fund method.
You can use the following example to use the default credit card on file:
 
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>1990775</retailer_id>
    <action>fundOrder</action>
    <fund_method>default_payment_account</fund_method>
    <cvv2>123</cvv2>
    <order_ids>
      <order_id>327873</order_id>
    </order_ids>
  </request>
</dce>

If you need to add a card when you have an order to fund, you can do it with the following:
 
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>1990775</retailer_id>
    <action>fundOrder</action>
    <fund_method>new_payment_info</fund_method>
    <cvv2>123</cvv2>
    <billing_city>North Pole</billing_city>
    <billing_country>US</billing_country>
    <billing_firstname>Joe</billing_firstname>
    <billing_lastname>Schmoe</billing_lastname>
    <billing_phone>888-555-1234</billing_phone>
    <billing_postal>10101</billing_postal>
    <billing_state>AK</billing_state>
    <billing_street>123 Candy Cane Ln</billing_street>
    <credit_card_exp_month>01</credit_card_exp_month>
    <credit_card_exp_year>22</credit_card_exp_year>
    <credit_card_number>4111111111111111</credit_card_number>
    <order_ids>
      <order_id>327873</order_id>
    </order_ids>
  </request>
</dce>
 
 
 

Did you find this article helpful?