Paysafecard

Supported Brands

Brand Name

PAYSAFECARD

Transaction Types

Meaning

Success return codes

DB

Debit of the card without prior authorization request

000.000.000

Create the checkout

Create the checkout: https://test.oppwa.com/v1/checkouts/

// GET Request to the following endpoint:

//https://test.oppwa.com/v1/checkouts/

amount=1.00 //currency has to be EUR on Test environment and BRL on Production

currency=EUR

paymentType=PA//your API Credentials

authentication.userId=8a8294174ae82ada014aedf7fb151d5f

authentication.password=AKdx7nmH

authentication.entityId=8a8294174ae82ada014aedfd75aa1d79//end of API Credentialscustomer.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

Successful Response

Response Checkout

{

"result":{

ㅤㅤㅤ"code":"000.200.100",

ㅤㅤㅤ"description":"successfully created checkout"

},

"buildNumber":"beb408d1f2c902bfb8665e2b4e268f1039848d03@2016-02-16 12:49:58 +0000",

"timestamp":"2016-02-16 13:25:09+0000",

"ndc":"DA84DCEB01BD28810E992D9EC8085985.sbg-vm-tx01", ㅤㅤㅤㅤㅤㅤ"id":"DA84DCEB01BD28810E992D9EC8085985.sbg-vm-tx01"

}

Create the Hosted Payment Page / Payment Form

Payment Form

<script> // Display the CPF number and set language to Portuguese

var wpwlOptions ={ showTaxNumberField:true, locale:"pt"}

</script>

<scriptsrc= "https://test.oppwa.com/v1/paymentWidgets.js?checkoutId=75E53EDE2467B24C179501962555376C.sbg-vm-tx02">

</script>

<form action=" {shopperResultUrl}" class="paymentWidgets">PAYSAFECARD</form> // Define the brand PAYSAFECARD and also set the shopper result URL in which the shopper is being redirected to once the payment is conclueded

You will be re-directed to paysafecard. Please use this code to complete the payment: 1000009011101219

Get the payment status

Once the payment has been processed, the customer is redirected to your shopperResultUrl along with a GET parameter resourcePath.

Important: The baseUrl must end in a "/", e.g. "https://test.oppwa.com/".

Then, to get the status of the payment, you should make a GET request to the baseUrl + resourcePath, including your authentication parameters.Payment status

//GET Request to the following URL:

//https://test.oppwa.com/v1/checkouts/{checkoutId}/payment//The id is what you receive in the previous response once a payment was initiated. authentication.userId=8a8294184e736012014e78a17a6a15b0

authentication.entityId=8a8294184e736012014e78a17a5615ac

authentication.password=f2FEKZqtBz

We recommend that you verify the following fields from the Payment Status response, by comparing the returned values with expected:

  • ID(s)

  • Amount

  • Currency

  • Brand

  • Type

Field specifications

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}

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}

Last updated