Skip to main content

Payment parameters

When you accept a payment from these countries, make sure you pass all the required parameters.

Payments through our widget​

If you use our payment widget, when you create a session, make sure you pass the following parameters with sender information:

  • full_name
  • first_name
  • last_name
  • city
  • street
  • ipv4
  • postal_code (up to 6 digits)
  • email
info

If you do not pass these parameters, we will generate them on our own (except for the first and last names), but the conversion rate might be worse.

Example of a session/create request​

curl -X POST \
  https://demo.smart-glocal.com/api/v2/session/create \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "amount_details": {
      "amount": 10000,
      "currency": "usd"
    },  
    "participant_details": {
      "sender": {
        "full_name": "Helen Adams",
        "first_name": "Helen",
        "last_name": "Adams",
        "city": "Miesenbach",
        "street": "Templstrasse 8",
        "ipv4": "112.34.152.137",
        "postal_code": "93401",
        "email": "helen.adams@hotmail.com"
      }
    }
}'

Payments without our widget​

When you make a payment, make sure you pass the following parameters with sender information:

  • full_name
  • first_name — mandatory
  • last_name — mandatory
  • city
  • street
  • ipv4
  • postal_code (up to 6 digits)
  • email

You can pass these parameters within any of the methods:

  • session/create
  • session/start/payment
  • session/init/payment
info

If you do not pass these parameters, we will generate them on our own (except for the first and last names), but the conversion rate might be worse.

Example of a session/create request​

curl -X POST \
  https://demo.smart-glocal.com/api/v2/session/create \
  -H 'content-type: application/json' \
  -H 'X-PARTNER-PROJECT: your_project_name' \
  -H 'X-PARTNER-SIGN: signature' \
  -d '{
    "amount_details": {
      "amount": 10000,
      "currency": "usd"
    },  
    "participant_details": {
      "sender": {
        "full_name": "Helen Adams",
        "first_name": "Helen",
        "last_name": "Adams",
        "city": "Miesenbach",
        "street": "Templstrasse 8",
        "ipv4": "112.34.152.137",
        "postal_code": "93401",
        "email": "helen.adams@hotmail.com"
      }
    }
}'