PrimeiroPay
  • PrimeiroPay
  • Getting Started
    • Server To Server API
      • Preauthorization Card
      • Capture
      • Debit
      • Refund
      • Reversal
      • Schedule a Payment
      • Recurring
        • Initial Payment
        • Repeated Payment
      • Tax Identification Number
    • Hosted Checkout
      • Copy and Pay
        • Customization
        • Advanced Options
  • Getting Start With Adyen
  • Cash Based Payments
    • Boleto
    • Baloto
    • Oxxo
    • PagoEfectivo
    • PIX
      • About Pix
  • Webhook
    • Webhook Integration Guide
    • Examples for decrypting message
  • Paysafecard
  • One-Click Checkout
  • Ckeckout PayPal
  • Pulling our FX Rates
  • Going Live
  • Connect to SFTP
  • Disputes
    • Dispute notifications via webhooks
    • Disputes guides
  • Force Result Code
  • API Parameters Reference
  • Reporting Guidelines
  • Result Codes
  • Plugins
  • Tokenization & Registration
  • Tokenization
Powered by GitBook
On this page
  • Supported Brands
  • Create the checkout
  • Successful Response
  • Create the Hosted Payment Page / Payment Form
  • Get the payment status
  • Field specifications

Was this helpful?

Paysafecard

PreviousExamples for decrypting messageNextOne-Click Checkout

Last updated 4 years ago

Was this helpful?

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:

// GET Request to the following endpoint:

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>

</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.

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:

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}

//

<scriptsrc= ">

Important: The baseUrl must end in a "/", e.g. "".

////The id is what you receive in the previous response once a payment was initiated. authentication.userId=8a8294184e736012014e78a17a6a15b0

https://test.oppwa.com/v1/checkouts/
https://test.oppwa.com/
https://test.oppwa.com/v1/checkouts/
https://test.oppwa.com/v1/paymentWidgets.js?checkoutId=75E53EDE2467B24C179501962555376C.sbg-vm-tx02"
https://test.oppwa.com/v1/checkouts/{checkoutId}/payment
test@test.com
http://merchant.com/success.php