Tableau de bordAPI ReferenceObtenir une clé API
API Reference

Complete an initiated payment request

patch
https://api.test.bictorys.com/pay/v1/charges/

Use this endpoint to complete an initiated charge request. When a request to /charges endpoint is initiated without
precising the payment method, the system create a charge objet and redirect payment page url. Hence
the customer can select the payment method and complete the form if needed then confirm payment

Path Params
uuid
required

Unique identifier of the charge object.

Query Params
string
enum

The type parameter allows to select the checkout service provider. E.g mtn_money, orange_money, wave_money, move_money

Body Params
double

Optional. Amount to be charged.

string

Optional. The currency to charge the customer. Required only if amount above is set.

orderDetails
array of objects

list of purchased items

orderDetails
string

Optional. Payment reference to be shown on payment page.

string

The identifier of the device used to make the payment

uuid

Optional. Unique Id of the customer. If provided, customerObject object below will be ignored.

customerObject
object
string

Recommended. The country where the payment should be processed. For card payment, it's the country where the merchant entity is registered. For mobile Money, it's the country of the customer. If not provided, the country of the merchant is used.

cardObject
object
tokenizedCardObject
object

Tokenized card Object used to make tokenized charge with /charges endpoint.

boolean

request approval from card issuer to reserve an amount on the holder card to pay later the transaction. When set to true, an authorization request will be send to card issuer. If ignored or set to false, holder card will be charged immediately

string

Optional. any reference passed by the caller. It will be returned in the response and webhook payload.

string

Optional. User-agent will be redirected to this url after payment is successfully done

string

Optional. User-agent will be redirected to this url after payment is failed or cancelled. The same url can be used for both succeed and failed transaction

boolean
Defaults to false

Optional. In the case of checkout or iframe integration, the customer can update phone number or other details, this information are used or the payment. By default, customer profile is not created or updated in this request. If you want that we update customer profile, set allow_update_customer to true. However we recommend to create customer using customer before using charge API

Headers
string
required

value of op_token returned in the CheckoutLinkObject

string

HTTP request identifier allow to trace individual request sent from client to service.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

401

The caller is unauthenticated

403

Access rights not sufficient

Updated almost 2 years ago

Language
Credentials
Header
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json
Updated almost 2 years ago