Submit Payment Information

Used when submitting payment for finalization. It could be used during direct API integration or via SDK / Button integration. Many of the data is optional; If optional data is found to be required after submitting payment information, buyer will be redirected to a Pipwave-controlled page which collects the required information in merchant’s behalf. Initiate Payment API call must be done before payment information can be submitted via Submit Payment Information API call. The Request data of this API call is very similar to Initiate Payment API call, differences being:

1. amount, currency_code and many other order-related parameters are not in Submit Payment Information API call
2. payment_method_code and extra payment parameters within payment_info is not a parameter in Initiate Payment API call
3. pw_id must be provided by Submit Payment Information API call, being a pair from Initiate Payment API call
4. Any other overlapping parameters from Submit Payment Information API call will overwrite the data within Initiate Payment API call

Method: POST

Action: submit-payment

Request

Format: POST data

• action required : string (32)

• timestamp required : timestamp

• api_key required : string (32)

• token required : string (32)

• payment_method_code : string (32)*

• payment_info : key-value *Only up to 100 values, must be PG-specific

• session_info : key-value

• session_info.ip_address : string (45)

• session_info.language : string (5)

• buyer_info : key-value

• buyer_info.email : string (255)

• buyer_info.first_name : string (255)

• buyer_info.last_name : string (255)

• buyer_info.contact_no : string (255)

• buyer_info.contact_no_country_code : string (3)

• billing_info : key-value

• billing_info.name : string (255)

• billing_info.address1 : string (255)

• billing_info.address2 : string (255)

• billing_info.city : string (255)

• billing_info.state : string (255)

• billing_info.zip : string (255)

• billing_info.country : string (255)

• billing_info.country_iso2 : string (2)

• billing_info.contact_no : string (255)

• billing_info.contact_no_country_iso2 : string (2)

• billing_info.email : string (255)

• shipping_info : key-value

• shipping_info.name : string (255)

• shipping_info.address1 : string (255)

• shipping_info.address2 : string (255)

• shipping_info.city : string (255)

• shipping_info.state : string (255)

• shipping_info.zip : string (255)

• shipping_info.country : string (2)

• shipping_info.country_iso2 : string (2)

• shipping_info.contact_no : string (255)

• shipping_info.contact_no_country_iso2 : string (2)

• shipping_info.email : string (255)

* - Not required for direct API, but SDK will automatically populate based on buyer’s selections

Response

Format: JSON

• status : string (5)

• message : string (255)

• redirect_url : string (255)

• payment_status: string (5)

• payment_reason : string (255)

Signature

There is no need to include signature in this API call.