Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Supported Brands

Brand NameInstallments
VISA2-12
MASTER2-12
ELO2-12
AMEX2-12
HYPER2-12

...

Create the checkout


Code Block
languagexml
firstline1
titleCreate the checkout: https://test.oppwa.com/v1/checkouts/
linenumberstrue
// GET Request to the following endpoint:
// https://test.oppwa.com/v1/checkouts/

amount=1.00

currency=BRL

paymentType=PA//your API Credentialsauthentication.userId=8a8294174ae82ada014aedf7fb151d5f
authentication.password=AKdx7nmH
authentication.entityId=8a8294174ae82ada014aedfd75aa1d79
//end of API Credentials
customer.ip=1.1.1.1
customer.email=test@test.com
merchantTransactionID=1234 //this value will show up on settlement reports and serves as your reference for this transaction

...

A capture is used to request clearing for previously authorized funds.  A capture request is performed against a previous preauthorization (PA) payment by referencing its payment.id and sending a POST request over HTTPS to the /payments/{id} endpoint.  Captures can be for full or partial amounts and multiple capture requests against the same PA are allowed.


Code Block
languagexml
firstline1
titlecapture request: POST to https://test.oppwa.com/v1/payments/
linenumberstrue
// POST Request to https://test.oppwa.com/v1/payments/payment.id
//payment.id is the uniqueID that is returned upon a successful PA

authentication.userId=8a8294184e736012014e78a17a6a15b0
authentication.entityId=8a8294184e736012014e78a17a5615ac
authentication.password=f2FEKZqtBz
amount=1.00
currency=BRL
paymentType=CP

...

  • ID(s)
  • Amount
  • Currency
  • Brand
  • Type

Anchor
installments
installments

Installments

to add installments, add the following javascript in the hosted payment page / payment form. The example below will display then a drop-down of 2, 3 and 5 installments:

Image Added

Code Block
languagejs
firstline1
titleadding installments
linenumberstrue
  var wpwlOptions = {
      style: "card",
          onReady: function() {
            var numberOfInstallmentsHtml = '<div class="wpwl-label wpwl-label-custom" style="display:inline-block">Number of Installments</div>' +
              '<div class="wpwl-wrapper wpwl-wrapper-custom" style="display:inline-block">' +
              '<select name="recurring.numberOfInstallments"><option value="2">2</option><option value="3">3</option><option value="5">5</option></select>' +
              '</div>'; 
            $('form.wpwl-form-card').find('.wpwl-button').before(numberOfInstallmentsHtml);
          }
    }


Field specifications (additional parameters for OTAs apply Hotel reservations and Airline Ticketing)


Name

Description

Format

Example

amount

Amount of the payment request. The dot is used as a decimal separator.

N13
[0- 9]{1,10}\.[0 -9]{2}

1.00

currency

Currency Code according to ISO 4217 specifications of the payment request’s amount

A3 [a-zA-Z]{3}


BRL

customer.email


The (internal) email address of the customer


AN128 [\s\S]{6,12 8}


test@test.com

customer.ip

AN255 [\s\S]{1,25 5}


AN255 [\s\S]{1,25 5}


1.1.1.1

merchantTransactionID

Merchant-provided reference number

AN255 [\s\S]{1,25 5}


1234

shopperResultUrl

Result URL after payment is completet

AN2048

[\s\S]{6,2048}

http://merchant.com/success.php