Search the Aria Knowledgebase for
User Documentation, APIs, SDKs, and more!


Home > Aria Crescendo Documentation > Aria Crescendo core api > save_paypal_bill_agreement_m


Confirms that a billing agreement has been accepted by the account user, and that PayPal is able to authorize a payment against that billing agreement. The token is a PayPal session token created by the init_paypal_bill_agreement call. If the billing agreement was accepted, then Aria saves the associated agreement identifier in the database to use for future transactions with this account.The merchant must have their PayPal Payment Receiving Preferences (under Profile on PayPal) set to block "pay with eCheck" (the box must be checked, and this does not prevent PayPal users from funding transactions with their bank account). If this is not done, any end user who needs to pay remaining balances (beyond the amount in their PayPal account) with a bank account will be unable to make payments. When the box is checked, such bank account funded payments will be secured by the user's credit card in case the bank account transfer fails. The merchant may also choose to have alternate currencies converted to their primary currency on that screen. Merchants who would like to collect in multiple currencies should either elect to convert there, or add additional Currency Balances in their PayPal Profile.

Input Arguments

Req Field Name Field Type Max Length Description
required-icon.png client_no long 22 Aria-assigned unique identifier indicating the Aria client providing service to this account.
required-icon.png auth_key string 32 Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.





Aria-assigned account identifier. This value is unique across all Aria-managed accounts.

required-icon.png token string 20 PayPal assigned session token retrieved with init_paypal_bill_agreement
required-icon.png billing_group_no long 22 The unique identifier of the billing group.
  client_billing_group_id string 100 The client-defined identifier of the billing group.
  master_plan_instance_no long 22 The unique identifier of the master plan instance.
  client_master_plan_instance_id string 100 The client-defined identifier of the master plan instance.
  alt_caller_id string 30 Person or process that submitted the API call. This can be someone's user ID, or the name of an application.
  optional_transaction_qualifiers array   Array of additional values you can associate with this API call.
  brd_arrow.gif qualifier_name string 100 Name of the field you want to associate with this API call.
  brd_arrow.gif qualifier_value string 100 Corresponding value of the field you want to associate with this API call.

Output Arguments

Field Name Field Type Description
error_code long Aria-assigned error identifier. 0 indicates no error.
error_msg string Description of any error that occurred. "OK" if there was no error.
bill_agreement_id string Unique ID of the bill agreement (also referred to as a token).
paypal_email string  
paypal_payerid string  
paypal_payerstatus string  
paypal_countrycode string  
paypal_shiptoname string  
paypal_shiptostreet string  
paypal_shipttostreet2 string  
paypal_shiptocity string  
paypal_shiptostate string  
paypal_shiptozip string  
paypal_shiptocountrycode string  
paypal_addressstatus string  
Last modified


This page has no custom tags.


This page has no classifications.